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Summer is with us again and many of 
us head out to the brilliant sun we're 
having (in Britain anyway) and the poor 
QL gets left indoors. 

Pity, there’s been quite a bit happening 
lately. 

The Q40 is out and being used by ma- 
ny people. We got Bill Waugh to write 
about his experiences of acquiring a 
Q40 in this issue. Not all plain sailing by 
any means for Bill, but he got there in 
the end and seems quite proud of his 
new baby, as he rightly ought to be! 
The fly in the ointment is the colour dri- 
vers as ever Work is happening sure 
enough, but taking far longer than we 
all expected. 

QPC2 is edging ever closer to release. 
I've been using a irial version myself 
for a while now, which seems to ma- 
nage everything except printing to a 
parallel port! Impressive piece of soft- 
ware, | just hope it’s finished and avai- 
lable by the time this issue is out, since 
the trial versions some people have 
been using are due to expire by Au- 
gust. Without meaning to belittle the 
other QL emulators on the PC, QPC2 is 
long awaited by many and the answer 
to many a prayer, a very fast and com- 
patible emulator which happily lives 
alongside Windows and switches freely 
back and forth. Let's hope Marcel Kilgus 
comes up with the goods very soon. 
The QL has been acquiring quite a pre- 
sence on the Internet 


Dilwyn Jones 


lable on the internet to see just how 
many) | hope to provide some cover- 
age of what's happening on the Inter- 
net/World Wide Web in future pages. 
Roll on having a full Web Browser and 
Email software on the QL. We have 3 
reports and pictures from the USA in 
this issue. While the number of QL 
shows in Britain have been few and far 
between this year, the Americans got 
busy and organised 2 QL shows in 2 
weeks! One of the highlights of those 
shows was Simon Goodwin demon- 
Strating a MIDI connection from the QL 
via the network port - it just goes to 
show what can be achieved even using 
a good old QL. Al Boehm brings us the 
news of this. 

Phil Jordan is finally close to bringing 
The Library to reality and we'll nave a 
dedicated QL PD supplier once more. 
Phil's had problems since acquiring 
Steve Johnson's library disks - he’s had 
hardware failures and found the need 
to make many and sometimes exten- 
sive changes to the library to bring it 
up to date, but at last the catalogues 
are nearly ready at the time of writing 
this. 

Finally, although the ‘Embarrass The 
Editor’ caption competition in the last 
issue didn't attract as many entries as 
we'd hoped, it still provided a few quite 
amusing entries. Who won? Take a look 
inside... 


[ermopyIpZ 


of late, so | decided to 
compile a list of QL-re- 
lated sites I'd found on 
the Web. While writing 
that article, | came 
across details of a 
new facility, the Quan- 
tum Ring, a list of con- 
nected QL Web sites 
set up by Giorgio Ga- 
rabello in Italy - Gior- 
gio writes about it in 
this issue. AS more 
and more QLers get 
on the Net (look at 
the lists of QLers’ 
email addresses avai- 


Oh no! Here we 
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i remember this MDV 
cartridge which formatted 
to 250 sectors... and an 
80MHz old Q46...and..... 
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News 


Bill Richardson 


in order to use his garage for the 
usual purposes. instead of a re- 
pository for obsolescing QL 
parts Bill Richardson would like 
clear some of his older items 
which some of the less adven- 
turouse users might still be look- 
ing for such as Microvitec colour 
monitors, Dot matrix, and ink jet 
printers, ICs, Populated and un- 
populated JS and JM QL boards, 
Keyboards, some with mem- 
branes, and Base mouldings etc. 
If you are interested ask Bill for 
his lists. You might just find a 
bargain! 


Spell-Crio USA Version 
Just Words! has published a 
version of the freeware program 
Spelling-Crib containing a QTYP 
dictionary with USA English 
spelling. 

A copy of the dictionary in Digital 
Precision Spellchecker format is 
also on the disk. 

Geoff Wicks, 28 Ravensdale, 
Basildon, Essex SSi6  5HU, 
United Kingdom. 

Tel +44-1268 281826 


RWAP Services 

The update to Release 2 of the 
SBASIC/SuperBASIC Reference 
Manual is now available cost u6, 
or you Can order this and either 
Release 1 update (needed if you 
bought a copy of the Reference 
Manual before 28/2/99) or 
pre-order the update to Release 
3 at the same time for only £10. 
The support disks were last 
updated on 30/5/99 (Q-Index is 
now v1.02) - you can update to 
the latest version by sending £2 
and the original disks to me. 
Q-Help vi.03 will be released in 
the near future. This will include 
all of the latest keywords added 
to the Reference Manual and if 
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you can display screens in 
excess of 512x256, you have 
the option of displaying a se- 
cond window at the side of the 
main text listing all of the help 
topics. You will also be able to 
move through the list of help 
topics by typing the first few 
letters. Updates to this latest 
version cost £1 - simply send an 
SAE and your disk. 


ZX Spectrum Emulator 


News 

from Davide Santachiara 
Zexcel, ZX Spectrum emulator 
48k/128k which runs under the 
pointer environment is now free- 
ware. You can get it from 
Davide's homepage: 
hitp://www.geocities.com/ 
siliconvalley/park/6533 

» QL software > Spectrum 
emulators 

or from Ergon Development's 
BBS area #55 

+39 0522 300509 from 21:00 to 
4:30 local time area zexcel.zip 
The manual is included in Quill 
format. 


Paragraph News 

from Francois Lanciault 

Work is progressing on v1.06 
(the free one) and 2.02 (for 
registered users). The hunt for 
bugs continue and many have 
been solved (mainly when 
changing page dimensions, lay- 
out manipulation and table mani- 
pulation). Also | might be close to 
find a solution to the stability 
problems of Paragraph. For ver- 
sion 2.02, the following features 
have been added so far. 
Configuration block. This is still 
incomplete as | need more infor- 
mation on how to handle some 
type of configuration. 
Justification of blocks of text has 
been added. Previously, it was 
only possible to justify a single 
line or a single Paragraph. Now 
several paragraphs can be justi 
fled in one command. Landscape 
support is now available and will 
print on all printers. User defined 


font size is now possible and 
more predefined sizes are 
available in the size menu. You 
can now see two pages at the 
same time on screen at 50% 
zoom. Useful for print preview, 

| will also try to include other 
new features in version 2.02 
such as: 

Exporting block of text or whole 
document in ASCII, add a way to 
re-order the regions in a layout, 
Autosave to another (configu- 
rable) file name, and a new way 
to define regions dimensions. 
But | must admit that most of the 
time | spent on Paragraph goes 
to bug resolutions these days. | 
really want the users to have a 
WP program that don't crash in 
their face more often than cer- 
tain WPs on certain other 
computers... 


Claus Graf Q40 Web 
Site 

| have set up a Q40 web site. If 
you want to, check it out, 
please. It is 

http://www.q40.de 

It is still under construction, of 
course. Now that | have finished 
some pages and | have learned 
how much effort it takes, | 
really appreciate Thierry’s site! 
So, please be patient. 

In the program download area 
you can find: 

* pqiv - a high color (!) image 
viewer for PCX and PIC files for 
Q40 

* qsplayer - a small sound 
player for Q40 (sample file 
included) and others. 

If you are interested in Q40- 
Linux, you Can register as an 
Linux/m68 user The registra- 
tion helps to encourage and 
support the Q40 Linux port as 
well as the whole Motorola 
680x0 series of computers: 
http://www.q40.de/os.himl 

or go straight to 
http://www.cs.kuleuven.ac.be/ 
~geert/Linux/m68k/ 
Registration.html! 
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Q40 Software News 
There is a new version. of 
QDOS for Q40: classic Beta n. 
You can find out about the 
improvements when you read 
the supplied readme file. 

The highlight is the new Soft- 
rom Toolkit. It allows QDOS 
classic to be loaded from 
SMSQ/E. 

You can get it from: 
http://www.q40.de/os.html 

or go straight to Mark Swift's 
site: 
http://pages.unisonfree.net/ 
mswift/files/QZ/index.html 


QCelt Software 

Q-Celt Software has released 
version 0.63 of the EasyBase 
database. This fixes some major 
bugs in the file import and merge 
routines - in particular, the record 
counter no longer becomes 
stuck at an internal count of -1 
when merging to an empty data- 
base (eg. when merging to 
reformat field layouts) and so 
prevents the scrambling of the 
database internal index leading 
to the scrolling of endless text to 
the screen. 

In addition, some minor updates 
to the QL Traders example file 
and to display output have been 
done. 

Q-Celt Software would like to 
hear from existing users who 
have ideas for any new facilities 
they would like to add to the 
program. 

Upgrades to previous versions 
are available from: 

Q-Celt Software, The Falconry, 
Glenmacnass, Glendalough, 
Co. Wicklow, Ireland 


More News from Q-CELT 
Q-Celt Software has now 
changed name to Q-Celt Com- 
puting to reflect the fact that we 
sell hardware now too. A forth- 
coming project from Q-Celt will 
be a pointer driven diary pro- 
gram for the QL, with possibly an 
art program as a longer term 
project. 
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The Library News 

from Phil Jordan 

The Library PD service is ap- 
proaching completion. 

| am currently finalizing the de- 
signs of the disk labels. | stil 
have a large number of files to 
sort through and either add to 
THE LIBRARY or where possible 
update earlier copies. 

The catalogue disks are fairly 
close now, so | hope to have 
posted the outstanding cata- 
logue requests before the next 
magazine comes out. | apologise 
for the delays. 

It has been a longer than expec- 
ted process to transfer Steve's 
massive Library to my system 
and change Names and 
Addresses as and where requi- 
red. | hope the worst is now past 
and that THE LIBRARY can 
continue to grow and maybe 
some of the software writers will 
supply demos of their lastest 
programs from time to time. 

Phil Jordan, The Library, 

42 Hawthorne Crescent, 
Cosham, Nr Portsmouth, 

Hants., England PO6 2TP 


QPC2 

Now, by the time you read this, 
QPC2 will be ready. After a long 
beta-test phase (which was quite 
good because a number of pro- 
blems have been fixed) QPC is 
ready to be released. No tricky 
DOS-installation is required, you 
can execute it straight from Flop- 
py Disk or Harddisk. QPC2 runs 
under Windows95, Windows98 
or Windows NT. The only require- 
ment: DirectX needs to be 
installed. 

QPC2 can be executed just like 
any other Windows program, 
you do not need to reboot the 
machine. You can switch with 
ALT TAB between any windows 
application and QPC - it is THAT 
easy now! 

A Demo version will be ready 
soon too which you can down- 
load from the JMS website, JMS 
BBS and from Marcel's QPC 
support site. 


Useful Events 

There were some reaction on 
Jochen’s events article in the 
last issue. Discussions are still 
going on. It is clear that some 
programmers would like to see 
this being implemented, and 
some would like to have more 
events as well. It would be so 
useful if jobs were to be in- 
formed when the display reso- 
lution changes, for example. May 
we ask programmers not to use 
bits 6 and 7 of the event bits for 
the moment? 


QL Hackers Journal 
Issue 31 of QL Hackers Journal, 
a free electronic QL magazine, is 
available from Tim Swenson’s 
Web site. It includes articles 
about his SuperBasic Source 
Book, Structured SuperBasic 
v2.6.1, FileConfig, Micro Emacs 
Macros and Program Internatio- 
nalisation - what's that? Guess 
you'll just have to read it to find 
out. Tim's Web site is on 
http://www.geocities.com/ 
SiliconValley/Pines/5865/ 


Editor’s QL Web Site 
Your friendly QL Today editor 
has finally clicked his pointer on 
the Web. Yes, | am in the process 
of setting up a QL-related Web 
site. Point your browsers at: 
http://www.geocities.com/ 
SiliconValley/Screen/3798/ 
index.html 

At the time of writing in late July 
there was only a_ temporary 
page, but more material should 
have been added by the time 
you read this. 


SET and ALTER 


Really last minute news: George 
Gwilt has modified the very use- 
ful SET and ALTER instructions 
from the DIY Toolkit (Simon 
Goodwin) so that they now work 
perfectly well in SBASIC and 
Masterbasic. You will find the 
explanation and the listing in the 
next QL Today. Thanks a_ ot, 
George! 

= 
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Caption Competition 


Runner up in our caption competition on page 4 
of the last issue was Phil Jordan with the fol- 
lowing entries. Might have stood a chance of 
winning if he hadn't tried to cheat with multiple 
entries. 
1. Is this a request from the neighbours? 
A local council requirement? 
2. Is it a bird, is it a plane, no it's the QL Today 
editor! 
Able to jump small rivers in a single (Quantum) 
leap. | said it would work this time! It works, Y 
PP BE 
3. If your name's Dilwyn you get a free pass, 
boyo. 


Hmmm. Other honourable mentions from various 

entrants include the following: 

1. Sensible street sign of the year award cere- 
mony. The sign should have read "DILWYN: 
Please drive your PC carefully’ He thought it 
read "DILWYN: Please drive carefully {into the 
ground)’ 


1 oe 


2. QlLloday finally takes off in a big way. Welsh 
efforts to get into space not entirely suc- 
cessful. Practising for the return flight to Wales. 


3. I'd rather be editing QL Today..” "Why did my 
mother have to call me ‘Dilwyn’ ?" Is this what 
he has to do to persuade people to write for 
QL Today 


But our winner is John Wakefield with the fol 
lowing entries. A small prize is on its way to Wor- 
thing, England for his efforts, he won because his 
entry was the most QL topical and the caption 
for photo number 3 in particular had the Editor on 
the floor with laughter 


John wrote: 

"Here is my official entry for the ‘Embarrass The 

Editor’ competition. My unofficial entry was far 

too rude. 

1. Welsh road sign equivalent to ‘SMSQ' (Stop 
Motorists Speeding Quickly) 

2. Rush to get into the ‘Queue For Tea’ (you have 
to say it) 

3. (QL) Quick Leek (one handed demonstration of 
UNZIP)’ 

= 
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42, Hawthorn Crescent, Cosham, Hampshire, P06 2TP. England, 
Tal, O1705 370874 
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Steve Johnson's 
massive Library 
is still growing 
Files added from 
around the world 


O/D<eheD 


QL loday 


The Quantum Ring: 


A QL Web Ring by Giorgio Garabello 
The Quantum Ring is a collection of QL Web sites linked 
to each other so that you can navigate back and forth 
through the chain of sites. Giorgio Garabello explains. 


The idea to set up ‘The Quantum Ring’ was born in 
December 1998. Looking at a friend browsing an airplane- 
related ring, | was struck by the ease of browsing and infor- 
mation retrieval. ie 
For who doesn't know what a Web Ring is: it is, in 
few words, a collection of web sites, linked to each 
other with the possibility to navigate upward and | th a 
downward through the entire chain. ae Cianee Bis 
Searching for rings discussing the QL, | found none, 
and so | asked myself: "Why can't | build one of 
these rings about this subject?”, 
My work got slowed down by a number of pro- 
blems, so in the end only in April was | was able to 
activate my own ring. Today, the ring is on, and it 
contains 4 sites at the time of writing. 
Very important: 
e This initiative has no commercial purposes (its only goal 
is the promotion of the QL) 
e tis legal and absolutely free 


ofwware Producer - BBS Fidoner BC BBS 


The home page address is: 
http://www. fortunecity.com/skyscraper/per|/357 /ringi.html 
To join the ring (ie. to add your own Web site to the ring) 

go to that page and follow these steps: ee im 

e Download a little HTML fragment and insert it into your 
page (if you can't find it go directly to: 

http://www. fortunecity.com/skyscraper/per|/ 
357/ringcode.html) 

e Copy this code into your page, in a noticeable 
place. 

e Fill the submission form. (you will be asked to 
enter a password of your choice - please don't 
forget it !) 

e Youll automatically be inserted in the potential 
member list. 

e last but not least, when done, send me an 
e-mail, and | will officially insert you into the ring; 
in return I'll answer to your request and inform 
other ring members of your arrival. 

e You could obtain some help from Tony Firshman if you 
are in trouble with all this mess. 

Now it's my turn to ask you a couple of things: 

e Please share this initiative as widely as you can 

e Subscribe to the ring 

e lf you publish something, I'd like to receive a copy of 
your writings. 


Giorgio Garabello, ql_torino@hotmail.com 
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US East Coast QL/TS May 1999 Show 


Al Boehm 


The show was in Spring Lake, 
New Jersey, a beautiful ocean 
resort town with a boardwalk 
along a wide white sandy 
beach. Since most people have 
to come from great distances 
and have to stay overnight 
anyway, it was a 2 1/2 day 
show. On Friday evening we 
gathered at the Cobblestone 
Restaurant for dinner and ge- 
neral discussions. 

On Saturday the show proper 
was held in a large church hall 
with a kitchen and coffee, tea, 
and sodas available all day 
long. Roy Wood, Tony Firsh- 
man, and Jochen Merz set up 


Herb Schaaf re-opens the time-tunnel 


vender tables. Also there was 
a flea market table with used 
software, boards, some Sinclair 
computers, and a lot of printers 
to be had for very low prices. 
There was also a virtual ven- 
dors table that had catalogs, 
displays, and order forms but 
no person. This table included 
adverts for George Morris’ 
Bible Study Helps For The QL 
User That is, George couldn't 
make the trip, but his wares 
were on display. An important 
concept, | think, for the smaller 
vendors that can not arrange 
to come to all the shows. 
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The TS in 
the show 
title stands 
for Timex 
Sinclair 
meaning 
the classic 
Sinclair 
computers 
ZX81, 
TS1000, 
TS2068, 
Spectrum, 


etc. HOW- (Herb has a LEGO-moment at Tony's stand 


ever very 
few TS per- 
sons showed up. | did sell two 
ZX8is at the flea market table. 

After a lunch 
J of subs and 
| pizza, we 
= had an after- 


ocal host, 
Bill McKel- 


f up a large 
iscreen on 
ithe stage 
|with a pro- 


Tony Firshman drew a lot of 
attention by showing the new 
Q40. Next 
Roy Wood, 
explained 
ProWess 
and Para- 
graph. Bill 
Cable — pre- 
sented a tu- 
torial on 
Pearl and 
advocated 
its use on 
the QL. 
Then came 
a remark- 


able demonstration in which 
kids were fascinated by the 
moving mathematical figures, 
programmers were interested 


in the complexities of the 
coding, and higher mathema- 
ticlans pondered the subtleties 
of the higher dimension 
shapes. Rarely do you see the 
whole audience enchanted as 
they were with Herb Shaff's 
Graphics On The QL demon- 
stration. Next there was the 
MIDI demo by Simon Goodwin 
and Al Boehm (See separate 
article). In the last presentation, 
Dietrich Buder displayed the 
capabilities of his Memo pro- 
gram. 

Years back, my daughter-in-law 
fussed at me for getting my 
son a QL since he stayed at it 
for hours and did not pay any 
attention to her Ever since, | 
have pushed for extra activities 


y QL - The Musical 
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Bill McKelvey nets a bunch of Europeans for his first sho to 


at meetings and shows for 
computer widows and orphans. 
Bonnie McKelvey led the fami 
lies to some of the points of 
interest in the local area. 
Saturday night we had a sup- 
per in the church hall followed 
by Rigel Cable performing 
some clog dancing. And then 
came the climax (nadir?) of the 
meeting with Liz and lan Podra- 
za and Al Boehm singing the 
world premier of: 


The QL Fight Song 

Chorus: 
QL Forever. 
We really think it's better. 
Its OS is unique, 
it rarely needs a tweak. 
QL Forever! 

1. Clive's microdrives were sec- 
torized as loopers, 
But a Miracle came in the form 
of cards Trump, Gold, and 
Supers! 

2. It was hard to reserve mem'ry, 
til we allocated heap, 
Now we hardly get the mes- 
sage - Not Complete! 

3. All the competition obsolesced 
to vapors, 
But the QL lives forever In 
emulators! 

Copyright Al Boehm. 


QL groups are permitted co- 
pies for singing as long as pro- 
per decorum is maintained. Of 
course, TV, Radio, Movie, Stage, 
etc. rights are reserved. A MIDI 
file is available on the public 
section of the NESQLUG web 
Site: www.airnet.net/boehm 
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Next a 
group of 
knowledge- 
able QL per- 
sonages 
formed a QL 
Forum. That 
is, they sat 
at a head 
table and 
provided 
» sage advice 


ultimate question, "Where is the 
QL going?’ they were clear that 
the QL needed a TCP/IP capa- 
bility. Most thought this would 


you Can bring them in with you 
and the restaurant will provide 
glasses, ice, etc. But the liquor 
stores had already closed! Well 
if you cant drink a beer then 
eat a banana split. 
On Sunday, we congregated at 
the McKelvey’s house where 
several QL’s were set up, a 
telephone line was available for 
modems, and mysteries of the 
QL were exchanged. We had a 
very American lunch of hot- 
dogs and hamburgers cooked 
on an outdoor grill Chris, a 
friend of Simon Goodwin, 
entertained us with a very im- 
pressive Egyptian dance. We 
ended the day by going down 
to the beach. 
F By that time | 
was com: 
pletely out of 
steam, but | 
think | saw 
Liz, lan, Si- 
mon and 
build- 


Tony, can you unZIP this person? from con- 


require a long software 
process, but Jochem Merz had 
heard of a possible cheap 
hardware solution. 

Finally Saturday ended with a 
retreat back to the Cobble- 
stone Res- 
taurant — for 
desert and a 
rehash of 
the events 
of the day. 
The local 
law is such 
that you can 
not pur- 
chase any 

alcoholic 
beverage at 
Cobble- 

stone but | 


quering their 


castle. 
[Pictures on the opposite page 
came from Al Boehm, the 


pictures on this page came 
from Joe La Punzina] 
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Gold Card / Atari / QXL Version 


Various Atari versions : call for details 


OPC 


|| | Shop hours : 
Mon - Fri 
10am - 6pm 
Wed / Sat 
| 10am- 2pm 


£ 90.00 (£ 70.00 SMSQ/E Owners) | 


With CUESHELL Module : 


| £ 110.00 (£ 90.00 SMSQ/E Owners} 


We can now supply colour laptops with OPC already 
installed | The systems are secondhand and vary 
considerably so you will need to call for details but 
a typical starting price for a 486 DX 70 Toshiba with 
350 Meg hard disk and 12 Ram complete with QPC 
and Carrying case is 


Q Branch News £500.00postage) _ 
Standard Q 40 package consists of : 
(40 Motherboard | 16Mb RAM / I/O card 


NA Prices 


Q 40 with QDOS Classic O/S £330.00 


Since we are now well into the summer 
there is not much new happening but things 
should change as we move into the autumn. 
The are many things being prepared at the 


| 


moment but summer holidays and the lure of | Q40 with SMSQ/E O/S £ 360.00 
the sun take their toll of programming time. cabs une aes 
Try to get along to the Paris show in al) aoe 

3 Hard Disk Drive P.O.A. 

September because that is where the more In Tower Case (New) £ 45.00 
interesting things should happen. in Desktop Case (2nd User) £20.00 

See you all there then. Keyboard £ 10.00 

Mouse £ 6.00 


Prices do not include postage and packing, 


PROGRAMMING 


QD 98 £53.00 
QD + QBasic £69.00 


SBASIC | SuperBASIC Reference manual £40.00 | 


Update Sheets / disk from earlier versions 
Postage extra : UK = £ 7.00 other places call for details. 


drives and all sorts of 
computer peripherals as 


QD + Qliberator + QBasic £ 110.00 Pel stet Don't forget you can 
Qliberator £50.00 | pop into our shop in 
Master Spy v 3.3 £30.00 New Versions | erage ay wae pe 
QPTR £ 37.00 New Prices _|_ too ! You can get disk 


Easyptr pt 1 & 2 (together) £ 33.00 


Easyptr pt 3 (C library) £16.00 


well as your QL 


ay i oe UTILITIES — | smelies 
Mon /JMon : ) 
Basic Linker £ 22.00 QSpread 99 £ 59.00 Text 8 7 
| DISA3 £ 37.00 Updates £18.00 | | | 
| QMenu £ 16.00 FIFi 2 £ 22.00 


'Fountext 94 £ 39.00 
| |2488 drivers £ 29.00] 
| |Epson ESC/P2 drivers} 


Cueshell 2 £ 30.00 
Qload / Qref £15.00 
Disk Mate 5 £16.50 


‘Just Words' by Geoff Wicks 
| THESAURUS, STYLE CHECK, SOLVITPLUS 3 
' £ 10.00 ea / ANY 2 PROGRAMS £ 18.00 /ALL3 PROGRAMS E£ 25.00 


| NEW VERSION --- STYLE CHECK 3 QPAC 1 £ 20.00 eee eo one | 
i; THESAURUS V4.01 / SOLVIT PLUS 3 v 3.00 QPAC 2 £ 40.00 F SMSQ wordprocessor | 
| Pointer drivens versions of Geoff Wicks popular programs. BOONES QTYP 2 £30.00 | | capable of handling the full | 
: { needs Hot_rext, WMAN and PTR_GEN or SMSQ/E to run} £ 1 0 00 f | screen on the Aurora /QXL/# 
| Upgrades from previous versions £2.50 + SAE. ; GLO £32.00 : | QPC systems. New drivers 

New manual for Style Check 3 £ 2.00 LDUMP £ 2 6. 00 : are currently being written. | 


\ Spelling Crib : PD program £ 1.50 +SAE 
\ or Free if you buy all three programs 


£ 25.00 _ } | 
QL te 


WATCH THIS SPACE ! i 


Q Count 
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Bes | Tel +44 (0) 1903-200212 fax +44 (0) 1903-208070 


Q Br a , 1 1) email dbranch@abranch.demen.co.uk web : hitp://0.qbranch.demon.co.uk 
Feeling out on a limb ? ’ 
Reach out for Q Branch. 3 

Suppliers of Quality CDOS/SMSOQ products % 
Hardware and Software. 


Tere 


Super Gold Card £ 160.00 
Recycled Gold Card £60.00 * 


The Bank Volt, 6 Coronation Buildings 
Ham Road, Worthing. 


W. Sussex. BN11 2NN. UK. Aurora £ 100.00 
Qubide £55.00 
Qplane £25.00 
ProWe S > Aurora cables £3.00 
ProWesS E 48.00 Aurora rom adaptor £ 3.00 
DATAdesign £ 24.00 The 'Braquet' £ 16.00 
EOneuts sick * when available. 
File Search £ 12.00 me ere ED 
PFlist £ 12.00 There are currently available : 
Fontpack £ 60.00 2 Used Gold cards 
LINEdesign v 2.16 £ 24.00 2 New Super Gold cards 
PWfile £ 18.00 QXL Supercharge Kit 
We have a few 33MHz 68040 processors, etc. which we can fit 
Pa rdgra p h to your existing QXL to increase its power and speed - call us for details 


The ProWesS word processor 


Package deals 


QXL II + SMSQ/E 
| Aurora + SMSO/E 


Demo version £ 1.50 + postage 
Full Registered version £ 18.00 


Above package + Monitor 


The MC - Plate 


Q Branch Programs 


The Knight Safe 1 - standard version £ 30.00 
The Knight Safe 2 - with compression £35.00 
Q - Count £ 25.00 


Pointer driven home accounting 
Q - Route v1.07 £25.00 


Route finding programme 
Coming soon ! 


Mark Knight's Fractal Programs. 
Stunning animated fractals on your QL | 


All the socket holes you will ever need on the back of 
your tower case. just rip off the silly PC thing and screw 
\__on this one. No cutting needed. What could be easier ? 


| 2nd user 14" VGA/SVGA Colour Monitors ! (suitable for Aurora) - i 
| Ready for use and giving all screen resolutions from 512 x 256 to 1024 x 576 | 
| 


prices start at £15.00 + shipping Only a few eft! J 


We can accept payment by VISA, Mastercard and Switch. You can also pay by{™ 
Eurocheques made out in Sterling or a Sterling cheque drawn on a UK Bank. | 
Prices include Post and Packing in Europe. 


Sse 


DIY_MIDI demonstrated at US Show 


Al Boehm 


Simon N. Goodwin, funded by NESQLUG (New England Sinclair 
QL Users Group) has developed a MIDI (Musical Instrument 
Digital interface) capability for the QL using the NET port. 


At the US East Coast QL Show 
on 29 May 1999, Simon had a 
Gold Card QL control a musical 
keyboard and play slow and 
rapid glissandos and other 
sounds. | (Al Boehm) had a 
Super Gold Card Aurora direct 
the music keyboard to play 
Twinkle, Twinkle Little Star as a 
single voice, then with harmo- 
ny, and finally a rock version 
with drums. 

The QL controls the musical 
keyboard with a set of new 
keywords developed by Simon. 
Only an inexpensive easily 
fabricated cable is required to 
hook up a QL NET port to a 
MIDI device such as synthe- 
sizer or a musical keyboard. 
One of the main keywords is: 
MIDILNOTE [#Ch]  note% 
[velocity%] where Ch is the 
MIDI channel, i to 16, note% is 
the note number O to 127, 
Velocity% is the keystroke 


speed, 0 to 127, which for most 
instruments is loudness. 


*.but | will play it in 4/4 ‘cause it's easier’ 


[ ] indicate this parameter is 
optional, if missing the default is 
used, 
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For example, MIDILNOTE 
#2 60,120 would start a note on 
the instrument sound 
(called a patch in MIDI) 
assigned to channel #2. 
For most instruments, 60 
is middle C and 120 would 
be forte (loud). 

There is also MIDILHUSH 
to stop notes, MIDILUSE 
to set channels, and 
MIDILPLAY to send a 
stream of MODI data. 
MIDILRATE is used to 
tailor the transmission 
speed for Trump, Gold, | 
SuperGold, etc. cards. 
Simon found a standard 
128K QL Is too slow but 
believes that if the 
DIY_MIDI codes were put | 
in a rom it should work. 
Also Simon has received the 
QXL NET code and is exploring 
how to adjust the DIY_MIDI 
codes to the QXL. 

Also included with DIY_MIDI is 
a Set of timing keywords useful 
for setting 
the right 


_ — currently 
f only works 
as MIDI OUT, 
_ that is, the 
/ QL sending 
| commands 
to a MIDI de- 
a vice. MIDI IN 
| with the QL 
receiving 
commands 
from a MIDI 
device is much harder Thus, 
the MIDI commands must be 
input to the QL via the key- 
board either in real time by 


pressing keys for notes or 
off-line by entering notes, rests, 
etc. into a music program {as 
yet unwritten!). Also the QL 
should be able to read MIDI 
files and then play them. (Also 
not yet written, but | am work- 
ing on it!) 


Bill McKelvey, the local host for 
the show, as a second job sets 
up equipment for bands and 
shows. He was excited about 
DIY_MIDI not for music but for 
using the MIDI commands to 
set his amplifiers, equalizers, 
(lights?) etc. for the shows. 
Since NESQLUG funded the 
development of DIY_MIDI, it is 
for the exclusive use of NES- 
QLUG members until 15 No- 
vember 1999 when it will be- 
come freeware. If you can't 
wait until then either become a 
NESQLUG member ($5) or beg 
Simon or me to let you nave a 
beta version to test or review. 
Also | am looking for other QL 
music enthusiasts to take part 
in some of the development 
work of the programs that will 
use the new keywords. My 
email address Is: 
boehm@ziplink.net 
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West Coast Sinclair Show 


by Tim Swenson, the show organizer 

The West Coast Sinclair Show was held in Union City, CA, on 5 
June 1999, one week after the East Coast Sinclair Show. Most 
of the European attendees arrived the Monday before the show 
and spent the week visiting San Francisco. 


The day before the show was 
by Bar-B-Q at my house. Be- 
fore the show a trip was made 
to a local regional park to show 
the Europeans a 
little bit of California 
nature. Luckily the 
side trip was en- 
joyed by all. 

The attendees at 
the Bar-B-Q were: 
Simon Goodwin and 
his girlfriend Chris 
Lyle, Tony Firshman 
Roy Wood, Jochen 
Merz, Marcel Kilgus, 9 
Dietrich and Inge 
Buder Jim Hunkins, 


Don Walterman, Roy, Jack Boatwright, John Rish and Tony at the Bar-B-O 


John Rish and Jack 
Boatwright. As eve- 

ning fell, Simon, Chris, Tony, 
Marcel, and | hopped in the Hot 
Tub for a bit of a soak. 

The day of the show | loaded 
up the station wagon QL stuff 
picked up a few folks at 
the local Motel and hea- 
ded for the venue. 

As this was the first show 
've organized, | was not 
too sure on how big a 
place to get. The venue 
was, Shall we say, nice and & 
cozy. There was enough { 
room for the vendors, but @ 
not really enough for a lot 
of milling about. 

The vendors were - Tony 
Firshman with his ever § 
oresent QL controlled 
LEGO robot, Roy Wood § 
demoing software on a 
Q40. Jochen Merz and Marcel 
sharing a table with their 
wares. Jack Boatwright was 
Selling the last of the stuff from 
RMG. John Rish (the sole US 
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QL & Z88 dealer) had mostly 
288 stuff set out on his table. 
Don Walterman had a Spec- 
trum 128 set up for all to see. 


Simon Goodwin tinking on a 
QL (one of two) that had been 
given as orphans looking for a 
new home, by a QLer that had 
upgraded to Macs. 


Ken Harbit drove from Fresno 
to pick up some T/S 2068 stuff 
and went home with one of the 
orphaned QLs. Bill Miller and 
Terry Greenlee (formerly of the 


Pennisula QL Group) made a 
surprize visit to the show. 

The key visitor to the show 
was the renowned author Stan 
Kelly-Bootle, writer of many 
computer books, including the 
‘Devil's DP Dictionary’, and the 
holder of the first post-graduate 
degree in Computer Science 
(from Oxford). 

Simon Goodwin has been a rea- 
der of Stan’s work for a number 
of years (so have |) and 
considers him one of the 
few that have really mas- 
tered the English lan- 
guage. When | mentioned 
to Simon that Stan was 
coming to the Show, Sr 
mon’s jaw literaly dropped. 
Simon got to spend a few 
hours chatting with Stan, 
smiling the whole time. 
There was no organized 
demonstrations or talks, 
just a whole lot of sinclair 
talk going on. Since | was 
| the organizer | was not 
" really relaxed enough to 
truely enjoy the show. 

When the show ended at 5:00, 
there was a debate on where 
to have dinner was held. Origi- 
nally, Tony and Roy were leav- 
ing for the Airport right after 
the show. Unknown 
to me, their flight 
was delayed 4 
hours and they had 
time for dinner after 
the show. Luckily 
everyone agreed 
on a place for din- 
ner and the restau- 
rant easily handled 
a group of 13. 

We are _ talking 
about plans for next 
year We have just 
# discovered a local 
‘Vintage Computer 
Show” that would be the right 
audience to advertise our 
show. Hopefully we can gene- 
rate more local attendees next 
year 
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"Hey look it works!" 


Bill Waugh 


Bill Waugh looks forward to his 
new Q40, but is not so sure with 
his record of hardware assem- 
bly. He got it working eventually 
but it cost him a lot in coffee 


though... 


| greeted the arrival of the Q40 
package from Qbranch with 
somewhat mixed _ feelings. 
While on the one hand | had 
been looking forward to its 
arrival and the prospect of 
Qdos running at Warp nine, the 
downside was that | also knew 
that my record regarding hard- 
ware assembly was a long way 
short of ideal, the trouble is that 
if you are not doing this sort of 
thing on a regular basis then 
you do not attain an upward 
moving learning curve, more a 
sort of switchback of success 
and failures. 

However as the package ar- 
rived on a Saturday morning it 
gave me the whole weekend 
to get it installed in to a desk- 
top case (nothing but the best 
for Hugh Forte). | had = pur- 
chased at a reasonable price a 
new 2.2 Gig hard drive and 3.5 
floppy; also in hand | had 16 
meg of RAM from a previous 
PC upgrade, | wasn't too sure if 
this RAM was suitable for the 
Q40 so did not order the Q40 
without RAM. 

The Q40 package contained a 
manual, a cardboard box inside 
which was the Q40, an 1/O 
board, a plate with ser ports 
and cables, 16 meg of RAM 
and a cute little laminated Q40 
logo (to stick on your compu: 
ters case). 

First thing to do is read the 
manual, next thing is to realise 
that no matter who you are you 
DO NOT take in everything you 
read at the first attempt, fact of 
life I'm afraid, we all have some 
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dodgy RAM up there in the 
grey matter and the longer you 
have been around the more 
dodgy stuff there is up there so 
at my age (nifty fifties) | tend to 
read things a few times. 

Ok several cups of coffee later 
and I'm ready to go. First, lay 
Q40 gently down into the case 
to see if the holes line up with 
the mounting posts in the case, 
no problem, three holes line up 
with brass stand offs on the 
case base and in this position 
the keyboard connector on the 
Q40 lines up nicely with the 
keyboard cable hole in the 
case; So if its going to sit in this 
position the next move is to 
see what all has to be con- 
nected and how. 

POWER CABLE - power to the 
Q40 comes not from the usual 
PC power connector such as 
used by Qplane but from a hard 
disc power plug this is a pro- 
blem as to get one of the plugs 
around to the Q40 socket is 
going to put some strain on the 
cable - Problem one. | remem- 
ber that | have an extension to 
one of these cables in an old 
PC case in the attic, this turns 
out to be a good thing anyway 
as the extension can be 
plugged into the Q40 and any 
time | want to disconnect the 
power to the Q40 | can pull 
apart the cable this avoids put- 
ting any strain on the Q40 
board as these cable plugs 
tend to be tight - Problem one 
solved. 


(0 BOARD - it is recommen- 
ded to push in the PC I/O board 
into the Q40 before fastening 
down the Q40 into the case to 
avoid putting excessive strain 
on the Q40 board, at this point | 
also connected the cables for 
the two ser ports and the 
video connector instructions 
with the Q40 are quite explicit 
and getting these connectors 
plugged in the right way is not 
a problem, however you may 
want to give some thought to 
which port you want to make 
Seri, why? well as it comes 
Seri uses a nine pin connector 
and Ser2 uses a 25 pin con- 
nector if you have opted for 
SMSQ/E for your OS you wil 
need a 25 pin to 9 pin adaptor 
to use Ser2 as the port for a 
mouse as SMSQ/E searches 
for a mouse in the order of 
Ser4, Ser3, Ser2 then Seri with 
a recommendation that you 
use the highest port available 
for the mouse, the easy way 
out is just to swap the Ser port 
leads on the I/O board thus 
making Serl Ser2 and vice 
versa, the problem with the 25 
pin adaptor is that it is too 
close to the Video port and will 
foul the video connector un- 
less you Shave a bit of it some- 
how. In practise | found the 
mouse works ok in both ports 
but presume Tony Tebby has 
his reasons for recommending 
the higher one. 

RAM - fitting the 16 meg of 
RAM into the Q40 is also not a 
problem it will only go in one 
way, | check at this point if the 
spare RAM | have looks any- 
thing like the RAM supplied, it is 
exactly the same so in it goes 
as well giving 32 megabytes of 
RAM surely it will be some time 
before | get an ‘out of memory’ 
report with that. 

DRIVES - before screwing the 
Q40 board down to the case | 
connect the hard drive and 
floppy drive cables onto the 
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I/O card while | can still see 
where pin one is on the con- 
nectors, this is denoted on the 
card by a small white triangle at 
each socket, pin one on the 
cable is the red wire. Every- 
thing looks in order so screw 
the Q40 board down and put in 
the screw for the I/O card and 
the one for other socket plate. | 
had fixed the hard drives {one 
2.4 gigabyte and one 1.2 giga- 
byte} and the floppy drive into 
the case sometime ago, all that 
was required was to plug in the 
cables following the conven- 
tion red wire (pin one) to the 
end of the drive connector 
next to the power lead. 

LEDS - all that remained were 
the wires for the various LEDs 
on the case, these are marked 
as to there use and the only 
thing left to work out is which 
way they go onto the connec- 
tor tral and error is the order of 
the day as getting them the 
wrong way around will have no 
effect other than they won't 
work. 

POWER UP - time for the big 
test, | connected the minimum 
needed to get a working sys- 
tem, a monitor keyboard and a 
power cable switched of at the 
wall socket, one final look in- 
side the case, ok everything 
seems to be connected; take 
one large inhale and switch on 
at the wall - nothing! Switch on 
at the case - buzz from the 
power supply whine from the 
hard drive as it fire up and then 
those all too familiar and very 
welcome red white and black 
windows -- Hey it worksllll, 

Yes it works! It's got the three 
channels look - umm - where is 
the cursor | should have a cur- 
sor - Problem two! 

The floppy light is still on and 
stays on, this is usually a sign 
that the floppy cable is con- 
nected the wrong way so 
switch off and connect cable 
with red wire away from drive 
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power supply. Switch on and 
the floppy drive light comes on 
will it go off? Yes it does and 
what's more | now have a Cur- 
sor - seems the Q40 was so 
busy trying to find Flpi_ it did 
not want to communicate, | 
check that the floppy cable is 
the correct way on the {/O 
board - it is; so it seems that 
Sony like to make their floppy 
drives a little different. Problem 
two overcome. 

Now that | have a cursor | can 
talk to the Q40. Wonder how 
much RAM it thinks it has; | 
type in ‘Print free_mem/1024 
and it comes up with 31447 so 
it has found a use for about 
540 K (about four times the 
128K of the old QL). 

FORMAT - next step is to for- 
mat the hard drives starting 
with the 2.4 Meg drive. | opted 
for SMSQ/E as | have got used 
to it on a QXL and then Aurora, 
So after going through the for- 
mat commands that safely al- 
low you to format a hard drive | 
get to type in FORMAT WINI_’ 
and enter Immediately and | 
mean immediately the wint_ 
Stats come up on screen, this 
can't be right it 's far too quick 
so | do a dir Wini_, it comes 
out at 2499805K, still suspi- 
cious | type in a few lines of 
SuperBasic and save it to 
Winl_sceptic do another dir 
and its there VIEW it and its ok 
- still suspicious (maybe some 
demon slave block quirk) 
power down then power up 
and load it in - yes it ok WINI_ 
is alive and seems to be well, 
onto Win2_. | use the same 
commands as before and then 
format WIN2_ this time nothing 
(I just knew things were going 
too well) after several more 
fruitless attempts it was time 
for coffee and quite reflection - 
Problem three! 

The coffee did the trick, the 
drive | wanted to use as Win2_ 
had been on my Aurora/Qubide 


system and a previous drive 
that had been used on this 
system had proved difficult to 
format when put back onto a 
PC as a backup drive, | decided 
to try and format it as Wini_ on 
the Q40 and see what hap- 
pened, after disconnecting the 
formatted Wini_ drive and set- 
ting the jumpers on the other 
drive to master | tried to format 
it, this time it worked fine and 
after changing the jumpers 
back to slave and re-connec- 
ting the Wini_drive | now have 
two formatted hard drives on 
the Q40 - problem three over- 
come. 

Mouse - | am of the rodent user 
type, SO power down - plug in 
mouse, power up, the Q40 
boots up very quickly but with- 
out mouse, try again but this 
time with mouse switched to 
PC (choice is PC - MS) - still no 
mouse and | must have a 
mouse, plan two try a different 
mouse several mice later no 
joy, | know you can use a 
computer without one but | 
can't remember all those hot 
keys, so must have a mouse, 
must have a mouse must have 
a coffee. 

Two coffees later | can't think of 
any reason why the mouse 
won't work, so | decide to re- 
move the I/O board and check 
the jumpers on it, there are 
probably a couple of dozen but 
they are positioned to give the 
impression of at least several 
hundred and the instruction 
manual (page) for the I/O board 
looks like it was written with 
the help of the Hubble teles- 
cope. Now in my capacity as 
an agricultural worker (honest 
we don't suck bits of hay folks) 
it is not everyday that we get 
to play with stuff like 1/O 
boards, in fact anything that 
requires a hammer of less than 
two pounds is regarded as 
quite delicate and skilled work, 
SO | approached this board of 
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several trillion jumper options 
with some respect and after 
some study with a magnifying 
glass between the board and 
its manual, | was sure every- 
thing was in order and plugged 
it back into the Q40. 

After screwing the Q40 back 
down into the case and then 
screwing the I/O board plate 
down | spotted what was pro- 
bably the cause of the mouse 
problem, the Q40 came with 
three rubber feet stuck on its 
underside in positions to sup- 
port it, these feet were rather 
large and screwing the I/O 
plate down was forcing the 
Q40 board to distort and make 
bad connection with the 1|/O 
board, leaving out the screw 
for the |/O boards plate solved 
the problem. Tony Firshman has 
since sent me three smaller 
rubber feet these allow the I/O 
board plate to be secured. One 
last word on mice - if you are 
moving from Aurora to Q40 


SMSQ/E then while an Aurora 
SER mouse requires to be set 
at MS, Q40 needs PC. 

So now that | had everything 
working it was time to install 
some software and see how it 
goes, ProWess wouldn't work 
until Roy Wood advised that 
the Cache needed turned off 
while some of the Prowes ex- 
tensions loaded, it pays to 
switch Cache on again as it 
gives a increase in speed by a 
factor of two to three, Other 
than the Cache problem and 
the fact that some SuperBasic 
Stuff was missing most of my 
stuff worked fine, and the 
speed at which the Q40 
booted up was very fast - 
about five seconds. Very 
shortly after the Q40 arrived 
an upgrade to the ROM was 
issued, this has slowed bootup 
a little as it has to be loaded in 
over the existing ROM, also 
some users reported a pro- 
blem with slow Floppy drive 


usage this attributed to a slave 
block problem. 

My overriding impression of the 
Q40 is its speed, | think it is 
possible that you could boot up 
a Q40, exec Text 87 write a 
short letter and print it before a 
Windows burdened PC was 
accepting input, but there again 
| am biased just a little. 

ls there a downside - well de- 
pends | think on how long it is 
before we get the Hi res colour 
drivers, | have been used to 
using Hi res screens with Auro- 
ra and QXL that | get a bit 
frustrated with 512X256 and 
Prowes does not look good at 
that resolution, however | doubt 
if Tony Tebby would have put it 
out without Hires in four co- 
lours unless he thought the 
colour drivers were close to 
completion. 

Lastly | would like to thank 
Peter Graf, Tony Firshman and 
Roy Wood for there efforts in 
bringing the Q40 to market. 


My BOOT and Qascade 


David Denham 


| have seen a number of arti- 
cles about people's extrava- 
gant boot files. While it's 
possible to pick up some inter- 
esting tips from these, I'm a firm 
believer in KISS (Keep It Simple 
Stupid), so | thought I'd write 
about how | use my QL by 
staying in charge of my compu- 
ter instead of it being in charge 
of my life. 

| use a JS rom QL with a se- 
cond hand Gold Card and a 
single DD disk drive plus a 
second hand Cub monitor | 
bought some time ago and a 
Canon Inkjet printer | don't 
believe in spending lots of 
money on the system. I'm not 
rich, the QL does what | need it 
to do, so [m happy keeping 
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things as simple as possible. | 
may have to upgrade to HD 
disk drives soon, as I'm finding 
it a little hard, not to mention 
expensive, to buy DD floppy 
disks at the moment. In the 
future | don't know what I'll do, | 
hate learning new things at my 
age, so! guess Il keep the QL 
going as long as | can. 

| have not always been a great 
fan of pointer environment, but 
it does have some merits, so | 
use it more often now than | 
used to and am gradually get- 
ting used to software like Qpac 
2. The beauty of booting from 
a floppy Is that if | wish to run a 
program without pointer envi- 
ronment e.g. an old program 
which won't run in pointer envi- 


ronment, | just reset the QL with 
that different disk in FLP1_. | 
doubt that would be so easy if | 
had a hard disk. 

| hate hotkeys and avoid them 
like the plague if possible. | 
cant remember more than one 
or two of them at a time and 
cant remember how to set 
them up either without looking 
in the Qpac 2 manual. | used 
them at first, but had to put a 
sticker on my monitor to re- 
mind me which key to use for 
which program. | hated that. 

| came across the Qascade 
program a little while back and 
boy has it made a difference to 
my setup. Before it, | used loads 
of buttons and hotkeys for 
everything, or just typed in 
loads of long winded EXEC 
commands in BASIC. Buttons 
were handy. | could see where 
everything was and just start 
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The BOOT Program 


110 device$ = 'FLPi_! 
130 MODE 4 

160 LRESPR device$&'ptr_gen' 
170 LRESPR device$&'wman' 


190 LRESPR device$&'qpac2! 


nN 
oO 
oO 
Ea 
sa 
ioe 
rd 
es) 


QREF ete 

runtime 

250 : 

260 ERT HOT_PICK ('b!',!') 


loads Quill 


loads Archive 
ARCHIVE 
loads Abacus 


indicator 


360 


380 


programs by pressing ENTER 
on their buttons. What | didn't 
like though was how much 
space the buttons took on the 
screen and the fact they dis- 
appeared behind the program 
display when using most pro- 
grams. With Qascade, just 
about everything can go in one 
button. It means an extra menu 
or two to wade through, but it’s 
worth it, because its made life 
quite a lot easier in many re- 
spects. 

What | don't like about Qas- 
cade is its manual. Setting it up 
initially was a bit of a nightmare 
for me (the command to set 
the colours for example) and it 
would be nice to see Someone 
redo this particular manual. 
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180 LRESPR device$&'hot_rext'! 


device$&! FileInfo2_bin' 
210 LRESPR device$&'qloadref_bin' 


220 LRESPR device$&'qlib_run336mod! 


230 LRESPR device$&'qlib_ext' 
240 LRESPR device$&!turbo_tk_code! 


280 ERT HOT_PICK ('q','Quill') : 
290 ERT HOT_LOAD ('R','flp1_Archive! ,p,256) 


300 ERT HOT_PICK ('r', 'Archive') 
310 ERT HOT_LOAD ('A', 'flp1_Abacus' ,p,256) 
320 ERT HOT_LOAD ('C', 'CAPSQUILL_TASK',U) 
330 ERT HOT_LOAD ('a', 'Abacus') 


340 ERT HOT_WAKE ('.', 'Button_Pick') 
350 ERT HOT_WAKE (CHR$(233), 'Button_Sleep') 


100 REMark everything loaded from "device$" 


140 TK2_EXT : REMark activate Toolkit 2 


: REMark Pointer Interface 
: REMark Window Manager 

: REMark Hotkey system 

: REMark QPAC2 


: REMark Fileinfo2 
: REMark QLOAD, QSAVE, 


: REMark QLiberator 


: REMark QLiberator extensions 


: REMark Turbo Toolkit 


: REMark pick BASIC 
270 ERT HOT_LOAD ('Q','flp1_Quill',p,256) : REMark ALT Q 


REMark ALT q picks Quill 
: REMark ALT R 


: REMark ALT r picks 
: REMark ALT A 
: REMark Caps Lock 


: REMark ALT a picks Abacus 


370 HOT_GO : REMark activate hotkeys 


390 PROG_USE device$ : REMark PROG default device 
400 DATA_USE device$ : REMark DATA default device 
410 EX device$&' qascade'; 'PROGRAMS 


«'&device$&'QASCADE_re! 


However, someone else gave 
me an example of their 
qascade_trc file (the file which 
controls Qascade) and working 
from this | came up with mine. 
Nothing terribly clever in it. If 
there was, | doubt I'd under- 
Stand it. Now | have it working, 
and am able to adapt it when | 
need to, | find it has simplified 
my life quite a lot. 

Qascade appears as a button 
with a green border on my 
screen. It has the title PRO- 
GRAMS as the name of the 
button. It was tempting to call it 
START like my friend's Win- 
dows 95 START button which 
does pretty much the same 
sort of thing, but resisted the 
temptation. 


| use Qed (a PD text editor from 
Holland) to edit the gascade_rc 
control file. It's fairly easy to 
use, quite adequate for my 
needs. | didn't like the fact that 
qascade needs TAB characters 
between everything, it's hard 
to make sure editors insert 
actual IABs rather than a 
column of spaces, then | found 
out that Qascade would accept 
semicolons instead of TABs, 
this makes life a lot easier. 

| haven't yet found a way of 
protecting memory from Quill 
Archive, etc within Qascade, so 
| have retained 3 hotkeys to 
load these programs and allow 
them 256k of memory each 
when they start - these are the 
ALT A, ALT Q and ALT R 
HOT_LOAD definitions. | follow 
a previously published conven- 
tion that upper case hotkey 
definitions load programs, while 
lower case ones pick those 
programs. A facility in Qascade 
corresponding to the P (Pro- 
tect?) [no, Psion - Editor] option 
in hotkey definitions would be a 
useful addition and enable me 
to do without hotkeys. The 
only other hotkey | use is ALT b 
to jump to BASIC when | need 
it 

There are 2 hotkeys | would 
not do without though. One 
(ALT dot) ensures the button 
frame Is visible, and the other 
puts programs temporarily to 
Sleep as buttons. Qpac2 has a 
thing’ (I think it's one of those 
Thing things anyway) called 
Button Sleep which can make 
most programs into a button - 
it's useful as it enables me to 
clear the screen momentarily 
without shutting down the pro- 
gram, then start something 
else to do a little job, then go 
back into the first program by 
pressing ENTER on its button. 
The CHR$(233) hotkey defini- 
tion simulates pressing ALT 
CTRL Fi to use button sleep. | 
noticed that Qpac2 and other 
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The file Qascade_re: 


# specify colours 
COLS; gwrgybwrwbrb 


AUTOKEY 

TITLE; Editors 
TITLE; Files 
TITLE;Graphics 
TITLE;MyPrograms 
TITLE; Programming 
TITLE; Qpaci 
TITLE; Things 


MENU; Editors 

HKEY;Caps Lock for Quill;C 
SBAS; Labeller; LABELLER_bas 
EXEC ; Qed; Qed 

EXEC; Typer; Typer 

EXEC ; Viewer; VIEWER_RTM 
MEND 


MENU; Files 

ETHG;Files FLP1_;Files;\DFLP1i_ 
ETHG; Files RAM1_;Files;\DRAM1_ 
ETHG; Files RAM2_;Files;\DRAM2_ 
ETHG; Files MDVi_;Files;\DMDV1_ 
ETHG; Files MDV2_;Files;\DMDV2_ 
EXEC;Archivers Control Panel;ACP_OBJ 
EXEC ; Discover; Discover 

EXEC ; QFormat;QFormat_exe 

EXEC; Textidy;Textidy 

MEND 


MENU; Graphics 

EXEC;Graphics Editor;Graphics_task 
EXEC;Convert PCX;PCX_obj 
EXEC;Graphics Viewer; GV_obj 


MENU; MyPrograms 

EXEC; Anagrams ; ANAGRAMS_TASK 

EXEC ; Codes ; CHARCODES_TASK 

EXEC; Colours; COLOURS_TASK 
EXEC;Graphics Editor;GRAPHICS_TASK 
EXEC; Labelling; LABELLER_TASK 

EXEC ; Sorting; SORT_TASK 

EXEC ; To-Do-List ; TODO_TASK 

MEND 


MENU; Programming 

EXEC; Config; Config 

EXEC ; Dataspace; DATASPACE_task 
EXEC ; MenuConfig; MenuConfig 
EXEC ; Proeman; Procman_PTR_obj 
EXEC ; QED; QED 

MEND 


MENU ; QpacL 

EXEC; Alarm; Alarm 

EXEC; Calendar;Calendar 
EXEC; Calculator; Calculator 
EXEC; Clock;Clock 

EXEC; Sysmon; Sysmon 

EXEC; Typewriter; Typer 


MENU; Things 

ETHG; Exec; Exec 

ETHG; Channels ;Channels 
ETHG; Files; Files 
ETHG ; Hotkeys; Hotkeys 
ETHG; Jobs; Jobs 

ETHG; Pick; Pick 
ETHG;Rjob;Rjob 

ETHG; Sysdef;Sysdef 
ETHG; Things; Things 
ETHG; Wake; Wake 

MEND 


programs use CTRL Fi for their 
"ZZzz’ functions, so ALT CTRL 
Fl seemed a good and memo- 
rable key combination to do 
this. 

| make a lot of use of Qpac2's 
Files menu to backup disks to 
ramdisk, then back to a blank 
floppy - | only have a single 
floppy drive on my system, so 
that's the only way to copy 
disks without going via micro- 
drive cartridges, but the disks 
hold 7 times as much as the 
cartridges so this isn't really 
viable. Anyway a 2MB Gold 
Card QL has enough free me- 
mory to hold the content of an 
entire DD disk in memory. This 
is why my qascade_rc file con- 
tains separate entries for each 
device for a Files menu - | can 
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Start the Files menu with any 
device by clicking on the rele- 
vant entry in the Files part of 
the qascade menu. 

| have started using Filelnfo2 to 
allow me to start regularly used 
text and database files without 
having to go through the pro- 
cess of starting a program then 
loading the file. | have several 
doc files with standard letters 
for my customers, so by start- 
ing the files menu to find the 
right file, then pressing ENTER 
(| dont yet have a mouse 
though! would increasingly like 
to get one, I'm sure driving qas- 
cade and qpac2 would be 
easier with a mouse than with 
cursor keys) it starts Quill then 
types in the keypresses nee- 
ded to drive Quills menus - F3 


for Commands menu, L_ for 
Load, the filename and finally 
ENTER - to make quill load that 
file ‘automatically. How it 
works is that the Execute com- 
mand in Qpac 2’s Files menu is 
taught that _DOC files belong 
to Quill, for example, so essen- 
tially Filelnfo lets Qpac2 exe- 
cute files which aren't normally 
executable by starting the pro- 
gram with which the files are 
normally associated. | got the 
idea from a PC owning friend 
who achieves the same thing 
from his equivalent of the files 
menu by double clicking on a 
file to start the program asso- 
ciated with that file Asking 
around, | was told there was a 
program called Filelnfo2 which 
could do pretty much the same 
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Pro WesS 


ProWesS is a new user environment for the QL. 
ProWesS is short for "PROGS Window Manager", 
but it is much more than that. Apart from a new 
window manager, 


want to 
extensions, 


run programs which need these 


The ProWesS reader is a major part of the| 
package. It is a hypertext document browser. This! 
means that text files which include formatting: 


commands (including pictures) and possibly link 
to other files can be displayed and read in this 
program. This is used in ProWesS to read (and 


possibly print) the manuals, and display the help’ 


files. The hypertext documents which are used b' 
the ProWesS reader are in HTML format, th 
format which is popular on Internet to display 
World Wide Web pages. 

Ancther important aspect of ProWesS is the 


possibility to allow programs to automatically’ 
install themselves on your system, and to be able. 


to run them without resetting the system. This 
means that, when you get a new program, all you 
have to do is insert the disk and indicate "start the 


program in flo1_", a menu option in the “utilities”, 
button. To install a program, you indicate "install: 


software", and the software can be added to your 


system. This way, you don't need to know how to) . 


write a boot file to use the multi-tasking 
capabilities of your computer. 


ProWesS includes many programming libraries. | 
These include syslib, an interface to the operating! 
system, PROforma, a vector graphics system, | 


allowing rendering both on screen and on paper 
(via a printer driver), The DATAdesign engine is 
also part of ProWesS. It is a relational database 
system with a bonus, as you don't even need a: 
key field. You get a powerful record at a time data; 
manipulation extension to the language you 
already use. Of course it also includes ProWesS 
itself, the new resolution independent window 
manager. 


Easy to use program to create listings on any. 


printer (especially inkjet and laser). This ProWesS 
application allows you to indicate the files which 
have to be printed. Each column contains a footer 
which can include the filename and filedate. The 
listings always allow perforation. PFlist can create 
el in two columns and in landscape (or | 
both). 


File search utility with many useful options, like 


the choice to search only files with a certain | 


extension, and whether or not the directory tree 
has to be scanned. All occurences of the 
searchstring will be displayed with line number or 
offset. You can also use special matching 
features, like case dependent, matching a space | 
with a stretch of whitespace, and searching for a: 
word dilimited string. 


it contains all the system. 
extensions from PROGS, and is essential if you: 


S fsearch| PFlist 


utils 


manage your font collection. You can preview 
fonts on screen, see what characters exist in a 
font and convert Adobe Type 1 and similar fonts 
for use in ProWesS. 


New PecWesS ofplication 
a fowerfid and very. uUsex | 
frvendly jfile Manager 


insluce subtree! 


a scadek)  ——_ Gemmands 
4: othsef Nat. 
> WIN app files Tree Al 


2334235 
Half : 24dkB 


1997 oat 


Liao Ofa fOr aTo 


Jeanfig of caenutil_h 
| \delete_s order_c 
jenglich_c raname_c oe 
jmenutil_s  fileinfos actions een i 


LINEdesign 


Create artistic drawings, technical drawings, process bitmaps 
(even scale and rotate them!), and any kind of vector 
drawings. You can use grpahics objects to create the most 
fabulous drawings ever seen. Because LINEdesign is a vector 
' drawing program, any part of the picture can be moved, 
scaled, rotated, slanted without any loss of precision or 
resolution. In LINEdesign, pictures are device independant, 
meaning that the printout will be the same on any printer (e.g. 
same size and position). 

| LINEdesign is good at handling text. You can easily put titles 
and full paragraphs on the page. All the fonts can be displayed 
;at any size, rotation, etc. All the fonts which are available to 
ProWesS can be used in LINEdesign. 

LINEdesign is a drawing program, but it can also be used by 
| people who are not good at drawing. LINEdesign is a great 
| program for making leaflets, posters, and any kind of printed 
|work, Lots of clipart and extra fonts are available from public 
domain libraries and BBS's. You can even import Adobe 
Illustrator files. 


DATAdesign 


Never before has it been so easy to create, fill in and maintain 
your personal databases. To start a new file, just type the 
/names of the fields. To add or delete a field, no problem, just 
| do it. To change the name of a field, just indicate it. You can 
choose which fields are displayed and also which records. You 
can have a hidden comment for each record, look at the file in 
tabulated form and transfer data to the scrap or hotkey buffer. | 
| Files can be memory based (for speed) or disk based (for 

| Safety). 


new 


d d ! Dr. Fr. Hemerijckxlaan 13 /1 hae ee (yey ane 62 4 | 
ax + | 
a TESS - Sun email : joachim@club.innet.be 


www : http: /www.club.innet.be/~year2827 


Fibs sh & Graphical Software 


ProWesS - BEF 2400 


Payment terms : 
You have to run FroWesS to make LINEdesign, DATAdesign, fsearcn, fonruti!s 


and PFlist work (even though DATAdesign uses wman). 


All our software is normally supplied on high density (HD) disks. However 
they can be obtained on double density (DD) disks at an extra casts of BEF 
100. To use ProWesS and any of our other packages, you need a system with at 
least 2MB of memory. You should have a harddisk although a two disk system; 
will also work. The use of SMSQ/E is strongly recommended for optimal use of || 


ProWesS. 


Ifyou are VAT registered (specify registration number) or live outside the EEC, 
the amount to be paid is the total (including postage) divided by 1.21 (no need 


to pay too much). 


Payment can be done by EuroCheque in BEF, or by VISA, EuroCard or | 
MasterCard. Credit card orders can be handled by phone. For credit card, 


please specify name of card owner, card number and expiry date. 
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DATAdesign - BEF 1200 
LINEdesign - BEF 1200 


PWrile - BEF 900 PFlist - BEF 600 
fontutils - BEF 1200 _—‘fsearch - BEF 600 
Postage : Costs of i and packaging have to be added. 


You can choose the quality. Rate depen is on no of programs. 
i[ priority mail "| ordinary mail 
| Copies Belgium Europe World | Belgium Europe World | 
[one || 100 200 | 240 |[ 100 | 120 | 145 | 
Bue | 135-340 | 420 | 135 | 190 | 230 
| 3or4/} 160 560 | 770 | 160 | 310 | 395 
5to8]; 185 870 1250 || 185 | 550 | 705 | 
more || 295 1130, 1610 || 295 | 800 1030 


"All prices are in BEF, including 21% VAT 
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thing for the QL. It took me a 
while to master it (I tend to use 
my age as an excuse for being 
slow with new software). It 
ought to be possible to get 
Qascade to call files like this 
using the Filelnfo method, 
though | haven't yet worked 
out how to do this. 

| use Archivers Control Panel to 
zip and unzip files, but there's a 
lot | don't know about this pro- 
gram which I'm sure I'm missing 
out on - for example, apart 
from ZIP what are the other 
compression programs it refers 
to? 

| have never really used . 


hotkey commands as | 7 
don't understand why | 
some Turbo compiled | 
programs don't work - | 
think it has something | 
to do with the code J 
modifying itself when it 46 
runs in some way. 
Since most of my pro- 
grams are self-written 
and compiled in Turbo, 
I've avoided the use of 
HOT_RES and those 
commands. 

| don't use subdirecto- 
ries with my floppy 
disks partly because | 
only recently began to 
understand them now | 
have a Gold Card, but 
also | don't think it's worth it 
with just a single DD drive. 

My KISS philosophy extends to 
the programs | use too. For all 
their faults, Quill) Archive and 
Abacus do what | need of them 
- writing letters, keeping lists - 
in fact they're probably my 
most used programs. At some 
point | may try to learn to use 
Exchange if it will run on my 
system, but for now I'm happy 
with good old Quill and co. | use 
a few PD programs such as 
Dilwyn Jones's text file viewer 
and a program called PROC- 
MAN which is a programming 
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utility | use a lot to extract 
procedures from my programs 
to transplant into other pro- 
grams. It's a bit slow with long 
BASIC programs, but does 
what | need quite admirably. 

On the whole, | write my own 
software and compile them 
with Turbo. I'm not proud of my 
programming skills and proba- 
bly wouldn't want to show my 
code to anyone else, but at 
least as I'm only inflicting them 
on myself (bugs and all) it's 
probably OK. 

FilelInfo has a_ little picture 
viewer which is quite useful 


Paphics oss 
WPrograms oe 


The MyPrograms menu in my 
Qascade menu has a few other 
programs in it really, but | cut it 
down somewhat to keep the 
length down for publication. If 
Dilwyn has space, perhaps he'll 
print the BOOT file and the 
qascade_rc file in the hope 
they may prove handy to 
someone. 

The gascade_rc file is a plain 
text file, it can be built using 
any text editor The first thing in 
mine is the hideously complex 
colour command - here it's set 
to green border around a white 
paper with a black title, items 


BL with a second hand Gold Card and a single 
S 4 second hand Cob moniter IT bo ght = Of 
=r 1 don tf t believe in 


just press ENTER on the file- 
name of the graphics file and if 
it's a type known to the viewer, 
it displays it. | wrote my own 
very simple graphics program 
which | keep updating from 
time to time in order to make 
cards etc for my business and 
generally to amuse myself | 
found it useful to get a copy of 
a program called Convert-PCX 
from DJC years ago. This con- 
verts some PC graphics files 
into screens for the QL, which | 
can then load into my program 
for some simple colouring or 
touching up. 


Selected become red and so 
on. 

It's split into 7 sub-menus con- 
taining most of the programs | 
use. | have yet to add some 
programs, that will be a future 
time passer for me | guess. 
The first menu contains items 
to start various text handling 
utilities | use, such as Qed 
editor a Quill CAPS LOCK indi- 
cator program, and a few 
others. The CAPS LOCK indica- 
tor program is a small Turbo 
compiled program which simply 
monitors the state of the CAPS 
LOCK button and print CAPS 


QL foday 


ON or CAPS OFF as appropri 
ate when it changes. Unfortu- 
nately, it’s positioned to appear 
on the bottom line of the Quill 
display, so pointer environment 
means it'd normally be buried 
under quill and unable to dis- 
play its output. Qascade_in- 
cludes no facility (as far as | 
know) to allow the little pro- 
gram to run ‘unlocked’ so | 
cheated and put it on a HOT_ 
LOAD hotkey with the 'U’ op- 
tion parameter to let the pro- 
gram run unlocked on top of 
another program, and used the 
HKEY command to execute 
that hotkey definition (a bit like 
a HOT_DO command in BASIC) 
to start it unlocked so it can 
write over the bottom line of 
the Quill display. 

The second menu contains a 
FILES menu call for each of the 
devices on my QL system - 
FLP1_, RAMI_, RAM2_, MDV1_ 
and MDV2_. | rarely use micro- 


drives nowadays unless | need 
to go back to an old business 
or text file still on microdrive 
cartridge, for example. These 
files menus are called as 
THINGS using the ETHG com- 
mand of Qascade (| don't pre- 
tend to understand this part, 
but it works). 

Discover and Textidy let me 
share text files with a PC 
owning friend. QFormat is a 
little program for quickly refor- 
matting used floppy disks. All 
these are simply started using 
EXEC in the normal way. 

The next 3 menus just contain 
normal programs to be 
EXECuted. 

The next menu contains the 
QPAC1 applications. | use the 
calendar and calculator con- 
Stantly, so these are on my 
working floppy ready to be 
called up on demand. It is temp- 
ting to load them at bootup 
since they are fairly short pro- 
grams, or to try to work out 


how to HOT_RES them, but it 
seems to work quite well for 
me done like this. 

The final menu calls up the 
‘things’ from Qpac2. | think it 
would be OK just to have a 
single call for the EXEC menu 
here and select the menu | 
want from that, but this is more 
versatile for me to be able to 
directly call whichever Qpac2 
menu | want. As | don't use 
these very often, it's handy 
having them in a single menu 
like this to prevent me having 
to go to look up in their manual 
how to call these menus when | 
want them! 

To add your own programs to 
these menus, all you'd have to 
do is add extra EXEC lines to 
one of the menus, between the 
MENU and MEND statements. 
The format is quite easy, it 
consists of (1) the EXEC state- 
ment, (2) a name which ap- 
pears in the menu and (3) the 
filename of the program. 


SRS SH Se 


as ss SHAS Soe STII SSS 


SN 


Nae es 


Operating since 1993 on a Sinclair OL from Utica, Michigan, USA 
Supporting ALL Sinclair and Timex users 
Message and File Areas for QL, Z88, Spectrum, TS2068, ZX81, TSsid00 
Modem speeds 300 bps to 33.6k bps supported 
24 hour operation - call anytime 


610-254-9876 
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The AUTOKEY command near 
the beginning automatically 
assigns keypresses to items in 
the menus. This is very useful 
for people like me without a 
mouse - it is quicker to press a 
single key than to steer the 
mouse to an item and pressing 
ENTER. 

Back to the BOOT program 
itself This starts by setting 
MODE 4 in case | start the 
machine in MODE 8 by 
pressing F2. Then it issues a 
TK2_EXT statement to enable 
Toolkit 2 on the Gold Card. The 
first 4 LRESPR lines install the 
pointer environment files and 
Qpac2 itself Then | install 
Fileinfo2, and some compiler 
files. QLOADREF is a Liberation 
Software utility with QLOAD 
and QSAVE commands for fast 
loading and saving of BASIC 


QREF which is a programming 
aid - it lets me have a list of 
variables and procedure names 
I've included in a_ program. 
QLIB_RUN336MOD is a modi 
fied version of the QLIB_RUN 
fle included with some 
QLiberator compiled programs, 
apparently this version fixes a 
minor bug in QLIB_RUN to 
allow it to be used with the 
Archivers Control ~— Panel. 
QLIB_EXT contains some ex- 
tensions to enable cursors and 
a few other things to do with 
the Qliberator compiler (which | 
don't own). Finally, this section 
installs the Turbo Toolkit, which | 
use a lot in my own programs. 
The first hotkey definition is 
one to let me pick BASIC at 
any time - the cursor jumps into 
the #0 window. | can jump out 
of a program into BASIC to do 
something then go back into 
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that program without having to 
quit first, this is probably the 
single best reason for using 
pointer environment on the QL | 
think, it makes little things like 
this so easy to do. 

The next few lines set up hot- 
keys to load the Psion pro- 
grams supplied with the QL. 
They use the 'P’ option to pro- 
tect about 256k of memory for 
each program. Pressing SHIFT 
ALT Q loads Quill with 256k of 
memory to tiself SHIFT ALT R 
does the same for Archive, ana 
SHIFT ALT A for Abacus. 
Pressing ALT and the lower 
case keys makes the QL jump 
into those programs If they are 
already running. 

Shift Alt C is defined to start 
the Caps Lock indicator men- 
tioned above. When used with 
Quill or any other program it 
has to be ‘unlocked’ so that it 
doesn't stop running when you 
are typing in Quill, for example. 
So | used the 'U' option in the 
HOT_LOAD command to un- 
lock its windows. It can either 
be started with SHIFT ALT C or 
from the Qascade menu 
described above. 

The HOT_WAKE "line makes it 
possible for me to see the 
Qascade button at any time by 
pressing ALT . 

The pointer jumps up to the 
Qascade button and | have to 
press ENTER to show its menu. 
From there | move the pointer to 
the name of the sub-menu re- 
quired, press ENTER and select 
which program | want to use. 
The HOT_WAKE CHR$(233) 
Statement enables me to re 
duce any running program tem- 
porarily into a button out of the. 
way by pressing ALT CTRL Fi - 
it works by calling the but- 
ton_sleep thing from Qpac2. 
The HOT_GO command ena- 
bles the hotkeys. Without this 
command none of them would 
work. Equally, while hotkeys are 
enabled, LRESPR wouldn't 
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work, Id keep getting ‘Not 
Complete’ errors, so it’s impor- 
tant to keep HOT_GO_ uniil 
after you've finished all your 
LRESPRs. 

The next two lines set the 
DATA_USE and PROG_USE de- 
faults to FLP1_. You may have 


noticed a  ‘device$=FLPi_’ 
command at the start of the 
program. If | ever upgrade to 
hard disks, this should help me 
move the boot program to 
WINi_ without too many chan- 
ges, although | haven't yet con- 
verted all the hotkey definitions 


- some of the still have explicit 
FLPi_ names in there. 

Finally, the last line starts 
Qascade itself, with the button 
name PROGRAMS (or what- 
ever name you care to enter 
here). 

| 


Gee Graphics! (on the QL?) - part 11 


Herb Schaaf 


"Persian" Recursions 
Recurs = goes back or comes 
back, 

As | write this I'm just back from 
the East Coast QL show. Simon 
Goodwin was there and what a 
delight! So many ideas put into 
my head, it will take me more 
time than | have to try them all 
out. Simon demonstrated MIDI 
via the QL network and also 
was showing many especially 
attractive graphics programs 
by Mark J Swift, Dave Halls 
Barker Robert James Nash, 
Mark Handley, and others. If you 


120 REMark Reference: 


140 WINDOW 512,256,0,0 : 
150 PAPER O:INK 7:CLS 


160 color_range = 16 
170 w = 256: h=w 
180 mesh = 1 

190 m = 2“mesh 

200 size = 0 


210 s = 2°size 

220 init_be = 2 

230 c = init_be 

240 1-0 : r=w : b=0: t=h 
250 DIM attrib(w,h) 

260 level = 0 

270 positions = 6 


290 IF stack_depth 1 : 
310 FOR i = 0 TO w STEP s 


320 FOR j = O,h 
330 = attrib(i,j)=c 


350 END FOR j 
360 END FOR i 


know these people, thank them 
for me and see if you can get 
them to write computer gra- 
phics articles for QL Today. 
One impressive — program 
shows a human head in 3d 
motion as done on the QL in 
1993(?). 

Another impressive — perfor- 
mance was presented by Si 
mon’s friend Chris. Her platform 
was McKelvy’s patio and the 
program included feminine 
frame animation sequences 
with rotations, translations, and 
zooms accompanied by the 


100 REMark PersianRecursion_bas 
110 REMark HL Schaaf June 15, 1999 for GG# 11 


"Persian" recursion by Anne M Burns 
130 REMark Mathematics Magazine V.70 N.3 June 1997, pi96-199 
MODE 8 


280 stack depth = (LN(w/(s))/LN(2))-mesh+1 
stack_depth =1 
300 DIM stack(positions, stack_depth) 


swish and jingle of small coins 
about her hips in synchrony 
with mid-eastern music. 
Speaking of mid-eastern, that 
reminds me of Persia and so 
brings us back (recurse) to the 
topic of this article, ‘Persian’ 
recursions. 

This time (GG#11) we will stray 
off-topic in several ways: 

1 - we try to force our way 
through a recursion algorithm. 
2 - we convert a program 
(more or less} from QBASIC to 
S*BASIC. 

3 - we can't foresee the results, 
but hope they will please. 

| hope you'll experiment, enjoy, 
and share. 

Il keep the S*BASIC_ listing 
brief and put REMarks in the 
text. 


370 : 
380 FOR i = 0 TO 2%(w-s) STEP gs 
390 FOR j = 0, h-INT((s/2)+.5) 
400 BLOCK 2*s,INT((s/2)+.5),(2*i) MOD (2*w),j MOD h,c 
410 BLOCK s,2%s,2%j MOD (2%w),(2*i) MOD w,c 

420 END FOR j 

430 END FOR i 


450 Cg 1,r,t,b 


470 PAUSE 

480 STOP 

490 : 

500 : 

510 DEFine PROCedure Cg(1,r,t,b) 
520 stack(0,level)=stack(0,level)+1 : 
530 stack(1,level)=1 : 
540 stack(2,level)=r : 
550 stack(3,level)=t 
560 stack(4,level)=b 


570 IF (r-1) « s * m: RETurn : 
580: : 
590 f = 0 
600 f = f + attrib(1,b) / 
610 f = f + attrib(1,t) y 
620 f = f + attrib(r,b) | 
630 f = f + attrib(r,t) : 
640 f = init_be +INT(f/4) + 3 : 
650 f = f MOD (color_range+1) 

660 c= 1+f 

670 : 


680 me = (l4r)/2 : mr = (t+b)/2 
690 stack(5,level) = me : stack(6,level) = mr 
700 level = level + 1 
710 FOR i = 1+s TO r-s STEP s 
720 attrib(i,mr) = ec : BLOCK s*2,s,((2*i)-s) MOD (2*w) ,mr~(s/2),¢ 
730 END FOR i 
740 FOR i = b+s TO t-s STEP s 
750 attrib(me,i) = ¢ : BLOCK s*2,s,((2*me)-s) MOD (2%w),i-(s/2),¢c 
760 END FOR i 
770 Cg stack(1,level-1) ,stack(5,level-1),stack(6, level-1),stack(4, level-1) 
780 Cg ste cepa ee ee anata eee atonea Pia ea 
3d 2 
); ) 


790 Cg stack(1,level-1),stack(5,level-1) ,stack(3,level-1),stack(6,level-1 
800 Cg stack(5,level-1) ,stack(2,level-1) ,stack(3,level-1) ,stack(6,level-1 
810 level = level -1 


SSS SSS SSIS SSIS SSSI SS SSSA S SSSA SSE SSS DNS 


820 1 = stack(1, level) id 
830 r = stack(2, level) : 
840 t = stack(3,level) : 
850 b = stack(4, level) : 
860 END DEFine Cg : 


QBASIC version of — the 
program in spite of his 
emotional dislike of the 


platform that it runs on you can 
see the algorithm | was 
working from to make a 
S*BASIC version. | think many 
of you can easily convert from 
one platform to the other and 
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'm sure you can simplify and 
improve my hack. Your 
comments and suggestions are 
welcome. | was not able to use 
a simple recursion as in the 
original program, but felt that 
the QL was surely able to to it; | 
just didn't know how! Perhaps a 
clever use of the ‘LOCafl 
keyword in a PROCedure or 


FU 
up using brute force to create 
a stack deep enough to hold 
the values for 6 positions at 
each level. Can anyone do it on 
the QL where the QL keeps 
track internally? “POINT’ in 
QBASIC is different from our 
QL ‘POINT’; the QBASIC 
“POINT” returns the attribute 
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(ink color) of a pixel on the 
screen; for the QL we could 
have use the PIXEL% from the 
DIY toolkit by Goodwin. | faked 
this by setting up an array 
‘attrib’ to hold the attribute. | 


used the QL BLOCK function 
instead of LINE and made use 
of the 2:1 graphics aspect 
combined with the 4:3 monitor 
aspect to make a rectangular 
rug that filled the QL screen 


instead of the square rug of the 
PC. Integer variables could 
have been used; | think that ! in 
QBASIC is like the % in 
S*BASIC. 


SCREEN 12 


bottom = 256 


END 


IF left « right - 1 THEN 


ColorGrid 
ColorGrid 
ColorGrid 
ColorGrid 
END IF 
END FUNCTION 


+ POINT(right, bottom) 
f= (p/4+ 3) MOD 16 
END FUNCTION 


ESAS SSSR RASS BLL 


You'll see that the next color is 
based on input from existing 
corner pixels, influenced by 
coefficients, factors, functions, 
etc. As it exists the symmetric 
result can resemble the de- 
signs seen in oriental rugs, 
hence the term Persian’ Re- 
cursion. It doesn’t have to be 
symmetric; by giving more influ- 
ence to two adjacent corners 
the design will begin to look 
more like a prayer rug. Certain 
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"Persian" Recursion by Anne M. Burns 
from Mathematics Magazine v.70 n.3 June 1997 p.196-199 
Reprinted with the kind permission of Anne Burns. 


DECLARE FUNCTION ColorGrid! (left!, right!, top!, bottom!) 
DECLARE FUNCTION f! (left!, right!, top!, bottom!) 
INPUT "Enter the border color ( 1 to 15 ) ", bordercolor 


LINE (left, top)-(right, top), bordercolor 

LINE (left, bottom)-(right, bottom), bordercolor 
LINE (left, top)-(left, bottom), bordercolor 
LINE (right, top)-(right, bottom), bordercolor 
k = ColorGrid(left, right, top, bottom) 


FUNCTION ColorGrid (left, right, top, bottom) 


e = f(left, right, top, bottom) 

middlecol = (left + right) / 2 

middlerow = (top + bottom) / 2 

LINE (left + 1, middlerow)~(right - 1, middlerow), ¢ 
LINE (middlecol, top + 1)-(middlecol, bottom - 1), ¢ 
ColorGrid(left, middlecol, top, middlerow) 
ColorGrid(middlecol, right, top, middlerow) 
ColorGrid(left, middlecol, middlerow, bottom) 
ColorGrid(middlecol, right, middlerow, bottom) y 


FUNCTION f (left, right, top, bottom) 
p = POINT(left, top) + POINT(right, top) + POINT(left, bottom) 


small parts of the design may 
resemble tartan, plaid, cam- 
paign ribbons and other kinds 
of textiles. There are so many 
variables you can fiddle with, 
and you have no idea as to 
what the result will be until it is 
done! If you discover what it 
takes to create a Sarouk, or 
Kashan, or Heriz, or Bukhara, 
etc. ‘On purpose, can you 
share the details with us? If you 
feel good about some com- 


SESE SSS SSSR 


SRNR 


bination you have found 
especially attractive please let 
us know how you did it. 


Here are a few of the many va- 
riables that can be worked with: 
‘size. aS exponent for s (s as 
integral powers of 2); range is 0 
to (8 mesh). size O is the finest 
resolution, size i is ‘blockier 
but faster size 3 begins to look 
more like a hooked rug, size 4 
is very fast and very blocky. 
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‘mesh’ as exponent for m (m as 
integral powers of 2); range is 1 
to (8 size). mesh 1 makes for a 
‘plush’ carpet. mesh 2 is faster, 
the warp and woof show like 
coarse needlepoint on mesh 
canvas. mesh 3 is threadbare, 
and mesh 4+ is bare threads. 
In the “f =" sequences you can 
use math functions of all sorts, 
and fudge factors to change 
the way the design turns out. 
You may use individual coeffi- 
cients and/or math operators 
and/or functions for each of 
the corners, subsets of cor- 
ners, and/or the entire collec- 
tion of corners. The additive 
term such as the 3 in the origi- 
nal list can be changed, nega- 
tive numbers can be used, etc. 
Then too, think of the ways you 
could (mis}piace parentheses, 
affecting the ways in which 
your expressions would be 
evaluated! 

The ‘colorange” can be 
changed; for the QL we can go 
as high as 255. 

You could in effect “pick your 
yarns’ by putting selected inks 
into an array, creating a palette 
having only those colors wan- 
ted, and perhaps having some 
influence over the desired pro- 
portions of each color. 

The initial bordercolor is set 
with ‘init_bc’; as written it Is 
red, changing it also changes 
the design! The range is 
O(black) to colorange. We can 
also try changing the QL to 
MODE 4. 


We can change the overall size 
by setting ‘w = to another 
number preferably (but not 
necessarily) a power of 2. The 
QL can go up to 256, while Au- 
rora should be able to handle 
512(?). If you have an Aurora, 
please try it and let us know 
how it works. 
Eventually we want to come 
back to an ink color and for the 
QL that means an integer in the 
range 0 to 255. 
There are so many ways to 
twiddle and play around with 
this kind of program. Repeated 
use of the RECOL command 
e.g. 
RECOL 1,2,3,4,5,6,7,0 
for instance, or 
RECOL 1,3,5,7,0,2,4,6 

will quickly bring up a Series of 
‘new’ arrangements. While the 
patterns remain the same the 
effect of changing colors 
brings out a variety of ‘new’ 
designs. All permutations of 8 
colors taken 8 at a time would 
involve over 40,000 variations! 
Another fun thing is to loop 
through the variables of mesh 
and size and watch the effect. 
Try 

"FOR mesh = (8-size) 

TO 1 STEP -1" 
or 

"FOR size = (8-mesh) 

TO 0 STEP ~1" 

with the appropriate placement 
and END FOR statements and 
watch the sucessive develop- 
ments. 


In her original article Anne 
Burns suggested using borders 
with more than one color, such 
as from dark to light; she also 
suggested trying quadratic, cu- 
bic and trignometric functions 
as just a few examples of ways 
io achieve variety. For “ambi- 
tious’ students she challenged 
them to take the idea used here 
with rectangles and then extend 
it to triangles and hexagons. 


References cited by Anne 
Burns in her article were: 
1 - AK. Dewdney's 

"The Armchair Universe’, 
WH.Freeman & Co., New York, 
NY 1988 

2 - ‘Cellular Automata Machines’ 
by T Toffoli and N. Margolus. 
The MIT Press, Cambridge, 
MA, 1987 


Now back to the East Coast 
Show. (that’s recursion for you!) 
Just before getting my own 
skit together for the show, | re- 
ceived a beta test version of a 
‘Portable Screen Toolkit’ from 
Mark Knight that lets you do 
some neat graphics; anima- 
tions, clip, paste, and more. 
Folks at the show saw the 
chaotic Lorenz ‘butterfly’ flutter 
by in stereo; that was done 
using just a few of the func- 
tions from Mark's toolkit. | hope 
to have a review article ready 
for the next issue. If not, then 
we will go on to shear and 
reflection of graphic objects in 
the QL. 


Style Check 3 from Just Words! 


written by Geoff Wicks 
A review by Henry Orlowski 


| was asked to review this software at the Bristol 
Workshop in Clevedon in April 1999. 

Geoff Wicks, the author also of QL Thesaurus 
and Solvit fame, attended the workshop and 
was able to give a full demonstration of its 
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capabilities to a live audience. 

| was aware that Geoff was achieving a very high 
level of interest in 
therefore very pleased to be given the 
opportunity to review it. So here goes..... 


the software, and was 
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1. What you get 
You get a single DD disk and one A4 manual of 
about 20 sides, half of which represent a de- 
tailed alphabetical glossary of usage, correct or 
incorrect. 

On first glance the manual 
gives the impression of being 
logically laid out and compre- 
hensive. It’s not bulky but it is 
detailed, with clear para- | 
graphing and headings, along | 
with pictorial representations 
designed to assist the user. 


2. What does it do? 
Style Check 3 (SC3) is a style 
checker, it says. There ap 
pear to be programs out 
there referred to as style 
checkers, but what does that 
mean? And is style checker the right terminology 
(in the absence of another) and does it accu- 
rately reflect the author's intentions and the 
software's capabilities? 

After all, “style” is a subjective feeling, not a 
computerised, digital, logical process, isn't it? It's 
something that a Byron, a Shakespeare or a 
Voltaire have, not what a Henry Orlowski can 
achieve with a computer program, | think. 

So the ultimate question in “style” may be whe- 
ther | wandered lonely as a cloud’ or ‘| wandered 
by myself through the lounge of the hotel looking 
for a program to 
review’ has ‘style’, 
or any style or no 
Style at all. SC3 
might warn me 
about my sen- 
tence length and 
that I've used the 
word ‘the’ twice, 
but the style of 
either may be ap- 
propriate to the 
circumstances in 
which they were 
written. 

SC3 will tell you if 
your proposed children's story may be only intelli- 
gible to university graduates, will warn you if 
there's a problem with your grammar, will warn if 
youre possibly using the wrong word, or will 
suggest a better or simpler word to use. For 
example it will highlight your use of less {is 
‘fewer better?), any instances of using a word 


LORD DOCUMENT: 


STATISTICS: ANALYSIS: 


LETTERS: 
SYLLABLES: 3858 
WORDS : 1941 
PHRASES : 238 
SENTENCES: 197 


PASSIVE: 


READABILITY: 
INDEX: 10.8 
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QUICK CHECK F STANDARD CHECK | sere | 


996 - 1999 Geoffrey Wicks 


una nvnastnenvancoeosnereneeataesecsatneg sca NTA ae eee TEA 


AVERAGE SENTENCE LENGTH: 18.1 words 
LONG WORDS: 15% 


PUNCTUATION FREQUENCY: 
% indicates possible style fault. 


: Secondary School Pupil 


too often, or even if you've used a double 
negative, and many others. 

In conclusion, it's not really style that we're 
talking about, but correct usage, grammatical 
usage, following rules or not. It's based on 


objective — rather 
than — subjective 
data. 

Nothing = wrong 


with that though. 
Style may remain 
at least for some 
time one of the 
aspects of huma- 
nity that still dis- 
tinguishes us 
from our digital 
assistants. 


3. What you need 

- a QL or QDOS/SMSQ compatible computer 
with at least 512K RAM, Toolkit 2 and the Pointer 
Environment. 

- Optional mouse and harddisk operation 

- Pre-prepared documents which must be in a 
choice of Quill, Perfection, Text 87 or Ascii 
format, in other words formats generally available 
to all QLers. 


Quick check screenk 
for review document 


4. The Manual 
It's always important to take a 
look at the manual as part of 
a review. 
As a rule of thumb, always 
read the manual first, at least 
quickly to get a “feel for the 
program and to help guide 
you if things dont quite 
happen as expected. 
In many cases you cant 
actually go through a manual 
unless you've got the pro- 
gram up and running in front 
a of you at the same time. This 
one is different though. | 
found it served as a good acquaintance and 
familiarisation read on its own, before running the 
program. Not necessarily to find out which but- 
tons to press, but more to learn what the pro- 
gram is all about, how it works, and what you can 
(or can't) expect it to do. 


13% 
Ruerage 
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| It is done! Anew major release of QSpread is ready! 
| We have added many features: 
QD-style toolbar with many additional functions. 
| QD-style menus, shortcuts and keystrokes. 
| SHIFT TAB gives very long formula entry line. mined (er, 2 APL ade ver cepson bes, 
ALT TAB moves up Pe Sueide grid - if you don’t have a 2 Elie ca ee 
| mouse 
| ESC puts QSpread to sleep. 
| QDs printer driver filters can be used for QSpread as well. 
| More intelligent confirmation request settings. 
All currency symbols are configurable now, including the 
EURO. October 
CNTNUM() just counts numerical fields in a range. poe 
Multiple "—" and "====" are automatically treated as text. eriseacoa. (Etcae oe. Riacd sare sss on 
Some special single characters like *|" are treated as text. a ee 
Automatic cursor-move after edit configurable, can also 
be turned off. 
New DATE macro function which inserts current date. 


mport filter: flpi_lfiiter_PsionImport 
ier ort filter: 


DATE format is configurable, it can be US-format or 4-digit 
ear. 
Default DATE separator character configurable. 


In addition, lots of long-standing 

bugs are fixed, e.g.: ae 
Window can be resized after Geneon 2768 
QSpread was put to sleep. fee nk Toe 
DATE$ shows  year-2k-dates 

correctly. 

Double "." and other problems 


in small numbers fixed. Lots of bug fixes in the formula parser done. 


ocal directories ay 


| These are the major changes, plus various minor ones, of course. You will get a new manual, not just additional pages. 


The upgrade price is DM 39,90. Please return master QSpread disk for upgrade. 
| Anew QSpread99 is price-reduced to only DM 149,- 


CueShell 


| A quick reminder: you can get QPC together with CueShell by adding DM 40,- to 
| the price of QPC. Even if you already bought QPC, you can add CueShell now if you 
like. Still only DM 40,-! Please return the original QPC master disk for an upgrade. 
| If you do not own QPC and you like to purchase CueShell: DM 89,- 
TERMS OF PAYMENT 


Postage and package [Germany] DM 8,99 (if total value of goods is up to DM 50,- then only DM 5,99). [Eurepe] DM 14,50 {i 
| total value of goods is up to DM 50,— then only DM 9,50). [Overseas] between DM 14,50 (1 item) and DM sen (ata at): Al 
— —_ i prices incl. 15% V.AT. (can be deducted for orders from peas 
non EEC-countries). E&OE. Cheques in DM, £’s, 


i 


sss) Eurocheques and Credit Cards accepted. 


| 
| se svenectod 
(_ suaceake. | eee eS 
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lim stillen Winkel 12 D-47169 Duisburg 
Tel. 0203 502011. Fax 0203 502012 
http://www. j-m-s.com/smsq/index.htm 


OPC II exists! 


| We’re not giving a full list of what QPC is: to make it short: it allows you to run the majority of 
| QL Programs on PCs, and comes with the QDOS-compatible (but much faster and better) 
operating system SMSQ/E. 


So what’s OPC II then? 


The more advanced version of QPC. Whereas QPC required your PC to run in DOS mode only 
while QPC was running, QPC IT now allows you to multitask with Windows95, 98 and NT. You 
do not need to run your system down and up to start QPC II, just double-click it and it starts. 
Also, the configuration of QPC II is MUCH easier - it is done in a configuration window where 
all settings can be easily done. 

Installation is much easier too, all is done automatically with an installation program, or you just 
execute it directly from floppy disk or harddisk. 

We have also reacted on the requests of many users: you can now have the QL windows scaled! 
For example, if you have a graphics card or a laptop with a resolution of 1024x768 pixels, then 
you can decide whether you want to use the full 
resolution (thus giving you 1024x768 pixels for the 
QL ... high resolution with small fonts) or if you 
want the 512x256 pixels to be scaled into 1024x768 
(so that you have a large, nice original QL display). 


So, with QPC II you get 
- the advantages of QPC 
- plus much easier installation 

| - plus much easier configuration 
- plus multitasking with Windows 
- plus scaleable screen resolution 


AT THE SAME PRICE AS BEFORE - only DM 249,- 


| You can upgrade to QPC II if you already own QPC by sending in your QPC master disk. 
| The price is only DM 79,90. 


| To run QPC IJ, you need to have at least a 486 or Pentium, 16MB of RAM, Windows 95,98 or NT and DirectX. 
TERMS OF PAYMENT 


Postage and package [Germany] DM 8,99 (if total value of goods is up to DM 50, then only DM 5,99). [Europe] DM 14,50 (if 
total value of goods is up to DM 50,- then only DM 9,50). [Overseas] between DM 14,50 (1 item) and DM 35,- (maximum). All 


i prices incl. 15% V.A.T. (can be deducted for orders from —{ aN 
i = non-EEC-countries). E&OE. Cheques in DM, £’s, rds | i 
cL ne) ee wees! Eurocheques and Credit Cards accepted. : fo 


a ES a 
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It’s laid out logically and allows you to enter it at 
different levels and stages. So it's easy to find 
the bit you need if you get stuck. Or it's easy to 
blitz through the Quick Start section if you can't 
wait to get 
your hands on 
the program. 
Or it's easy to 
quickly go to 
the Customisa- 
tion section if 
you dont like : 

the results you PRIMI (su punctustion frequency, 
get with the G ee occurs 4 times. 
current configu- 

ration. 
Essentially it's 
difficult to fault. It 
told me every- 
thing | needed 
to know, gave me no difficulties in finding the 
relevant section, explained the menu structure 
concisely, gave numerous examples in the glos- 
Sary, and covered everything. 


5. What you do 

The program isn't difficult to master It’s generally 
intuitive and clear in the presentation of options. 
And if you already run under the pointer environ- 
ment, you will certainly have no difficulties in navi- 
gating through the program, aided by the familiar 
buttons and menu items. Mouse users will find 
the operation easiest, but non mouse users have 
keypress options to obviate any inherent weak- 
nesses. 

When started the program presents you with an 
initial opening screen which allows you to check 
program information, enter the configuration 
screen or load a document for checking. You 
need to load a document to get the program to 
carry out its action, remembering that this 


SELECT ITEM WITH POINTER - HIT OR SPACE FOR HELP - 00 OR ENTER 10 CHANGE 


p LONG WORDS: Warns if the percentage of long words in a sentence longer than 18 
words exceeds the threshold level. Set to 25% for adults, less for 
children and more for academics. Set to 188% to switch option off. 
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So the ultimate question in “style” may be whether ‘I wandered lonely as a 
cloud’ op ‘I yondered by myself through the lounge of the hotel looking for a 
program ta review’ has “style",” or any style or no style at all, 


Possible hidden verb (word ending in -tion or -ment?. 
QUESTION: If moun, try SUBJECT, TOPIC, MATTER or PROBLEN. 
AS: Conjunction or adverb watch cose)? Often superfluous. 
NYSELF: Do not use “I myself", if it is unnecessar 


document must be in one of the compatible for- 
mats. 
You know your document is loaded when you 
are presented with the options of doing either a 
Quick Check or a Standard 
Check, although the document 
is not actually displayed. You 
are not obliged to do a Quick 
one before a Standard one. 
The Quick Check is a statistical 
summary of your document. It 
takes afew seconds to do, de- 
pending on the size of your 
document, and usefully pro- 
vides a basic progress meter to 
let you know it's doing some- 
thing. Once complete you get 3 
lots of information: 

Statistics. Word, letter sen- 
tence etc. counts. 

Analysis. Indications of average sentence 
length, percentage of long words, percentage of 


Help screen 


ER 


sentences with possible passive verbs, and 
punctuation frequency. No idea what a passive 
verb is? Check in the manual, or click Help. Any 
areas of possible style faults are highlighted, 
enabling you to pay particular attention during 
the Standard Check. 

- Readability Index. What? Well it’s a sort of 
number derived from an equation taking into ac- 
count the average sentence length and number 
of syllables per word. But you don't need to 
concern yourself with that, except to know that 
the range is from about 5 to about 20. Average 
band is 7 to 13. Below that and it's a children’s 
text. Above that and it could be a University 
doctorate thesis. Anyway itll also tell you 
whether the estimated reading level is for a 
young child, schoolkid, adult, student or 
graduate. 
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The Standard Check analyses each sentence in 
turn and displays warnings and comments. War- 
nings are more serious observations, comments 
less so. Throughout you must remember that you 
remain the final arbiter of whether the comment 
or warning is valid, or you want to accept it. In 
many cases the computer is not intelligent 
enough to distinguish between actual faults and 
possible faults, but at least highlights where they 
might lurk. Get stuck with a particular comment 
and need to know more? No problem, either 
check in the glossary or press Help to see if it's 
got something on it 

The comments relate to specific words which it 
highlights in the actual sentence. This works 
reasonably well but can be a little bit equivocal 
when more than one comment refers to the 
same word or sentence. The sentence is dis- 
played along with the comments of course, but if 
it is long, and there is a large number of com- 
ments, you may not see the whole sentence or 
even any of it at all. Disappointingly there is no 
option to go back or scroll it down bit by bit, so 
you have to restart it and try to catch it again 
before it disappears. Remember also that you 
cannot make any changes to your document 
whilst you are in SC3, so you have to either note 
all the comments down, or output to printer or 
file for subsequent reference and_ possible 
changes to the document. 

So what does it check for? All the options that 
have been set in the Configuration section, or 
already there by default. The list includes sen- 
tence length, long words, word repetition, passive 
verbs, split infinitives, hidden verbs, position of 
conjunctions and prepositions, and double nega- 
tives. If you don't like the default values it uses 
then you can change them in the Configuration 
screen. 

It will also give you comments on_ individual 
words, provided that it is configured to do so, if 
these words are contained within its own com- 
prehensive database. If you're not sure if youre 
using words like "deem’, “entail”, ‘lie’, *proscribe’, 
“strata’ or "who(m)’ correctly, then this will pick it 
up and highlight a possible fault. And if you don't 
like Geoff's headmasterly ‘style’, then you can 
easily edit the database, and add to it, or replace 
with your own. 


6. Conclusion 

SC3 is very good at what It states it does, but it’s 
not perfect and you still have to make up your 
own minds on how useful a program like this is. 
It is after all a usage checker more than a ‘style’ 
checker And as far as correct usage is 
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With the recent release of 
STYLE-CHECK 3, the upgrading of 
the JUST WORDS! program range is 
complete. 


All programs are now available in 
pointer driven versions and are fully 
mouse and high resolution screen 
compatible. 


They are not only better, but now also 
cheaper. 


SINGLE PROGRAMS: 
£10 OR €15 


THE COMPLETE SET: 


£25 OR €37 


Payment by sterling cheque or by giro 
transfer in euros to Netherlands 
Postbank number 4111942 (G.T. Wicks) 


Also availabie fom QBRANCH. 


Geoff Wicks, 28 Ravensdale, 
Basildon, Essex SS16 SHU, 
United Kingdom. Tel: +44 (0)1268 
- 281826 
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concerned, nowadays people tend to be more 
liberal in their approach and an insistence on 
correct grammatical construction and presen- 
tation is not the highest priority. And can a com- 
puter give you ‘style’ or is it a case of ‘you've 
either got it or you haven't’? 

Nevertheless, if you are more of a traditionalist, 
bemoaning the fall in standards of English, then 
this is the program for you. Or if you need to 
write texts, or reports, or need to address texts 
to a wider audience as part of a profession, then 
I'm sure you will find many of the aspects of this 
program useful, especially the readability index 
and estimated reading level, to ensure that your 
text is well aimed at its target audience. 


7. What it doesn’t do 

Can it be improved? Are there desirable improve- 
ments that could make the program more 
user-friendly than it is? Don't get me wrong, this 
program is good and does everything it claims, 
and very well. | know my old English teacher 
would have loved to have this program to 
illustrate all my (and my classmates) poor prose. 
But there are additional things you wish the 


program would do, if it were technically feasible. 
Here’s my wish list: 

- A ‘dir’ option to browse available files for 
loading, at least for those without Qmenu 
installed. Yes | know you can Ctrl C or whatever 
out and do a file listing, but the lack of this 
capability does detract from the attractiveness of 
the program. 

- Ability to view the loaded document from within 
SG3: 

- Ability to work on and amend ‘style’ faults as 
they are highlighted from within the program, and 
to resave the document in the original format. Is 
this what one would call checking documents ‘on 
the fly’? 

- A Standard Check progress meter to tell you 
the position of the sentence in the document, so 
you know how far through you are. - Ability to 
scroll back through checked sentences including 
and beyond the current sentence. 

Or maybe it would be nice if | stopped being so 
pernickety and just appreciated it for what it is. | 
do really. And did | dare get SC3 to check 
through this document? No, | didn't dare. 

& 


Missing Bits 


Apologies to Wolfgang Lenerz and the readers: due to a bug in the DTP program, part of his BOOT 
program (article was published in Issue 1 Volume 4) was missing. Here is the missing bit: 


2510 DATA "menu_rext", 28216 


2520 DATA "qmon_bin",12260,"jmon", 15684, "qpac2",, 38430, "qptr_bin", 9620 

2530 DATA "file_bin", 3896, "sub_bin", 2342, "qLib_run_336mod",10552, 'qref_bin' ,2478, 
"qlib_bin", 2910, 'qlib_ext',1472, 'qlib_ovl',1006 

2540 DATA “clavier_bin", 570, "outptr_bin", 8606 

2550 DATA "aff_bin",426, "qd2fi2_bin", 2242, "emul_bin",1700, "efg_bin", 1126 

2560 DATA "configure_bin", 566, "engine_rext", 25022, "minmaj_bin", 734, "wset_bin", 204 
2570 DATA "qd", 55802, "imp_bin", 3558, "mkdbwin_bin", 3946 

2580 DATA "prtbuf_bin", 1788, "setpos_bin", 138, 'is_proc_bin' , 1330 

2590 DATA "dll_rext",1760,"syslib_rext" , 39812, "global_rext", 1384 

2600 DATA "pwbasic_rext", 21870, "env_bin", 826, "gline_bin",408,"word_config_bin" ,468 


2610 : 
2620 DEFine PROCedure ws 
2630 LOCal xp 


2640 xp=xx+100 

2650 WINDOW XLIM,YLIM,0O,0:PAPER 0:CLS 

2660 WINDOW#0, XLIM, YLIM-28,0,28:PAPER#O,0 
2670  WINDOW#2, XLIM, YLIM-28,0,28 

2680 INK 7:OVER 1 :CSIZE 2,1 

2690 FOR n=i TO 10 

2700 CURSOR xp+n, 100+n 

2710 PRINT "WOLF Business Computer"; 

2720 END FOR n 

2730 CURSOR xp+n,100+n 
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2740 
2750 
2760 
2770 
2780 
2790 
2800 
2810 
2820 
2830 
2840 
2850 
2860 
2870 
2880 
2890 
2900 
2910 
2920 
2930 
2940 
2950 
2960 
2970 
2980 
2990 
3000 
3010 
3020 
3030 
3040 
3050 
3060 
3070 
3080 
3090 
3100 
3110 
3120 
3130 


3140 : 


3150 
3160 
3170 
3180 
3190 
3200 
3210 
3220 
3230 
3240 
3250 
3260 
3270 


3280 : 


INK 2:PRINT "WOLF Business Computer" 
CSIZE 0,0:INK 7 
OVER 0 

END DEFine ws 


DEFine PROCedure time 
all_months$="" 
a$=make_date$(1) 
ag="Paris, le "Ra$ 
ERT HOT_KEY('d',a$) 

END DEFine time 


DEFine FuNetion make_all_months$ 


REMark this makes a string "JanFeb..." in the current language 


LOCal string$,1p%,a$, temp 
string$="":a$="": temp=0 
temp=60%*60%*24%31 
FOR lp%=0 TO 11 

a$=DATE$(1p%*temp ) 
string$=string$ka$(6 TO 8) 
END FOR 1p% 
RETurn string$ 
END DEFine make_all_months$ 


DEFine FuNetion make_date$(dflag%) 
REMark returns current date in form 01.01.1991 (if dflag%) 
REMark else in format 1991.01.31 
LOCal a$,b$,res 
a$=DATE$ 
b$=a$(6 TO 8) 
res= b$ INSTR all _months$ 
IF NOT res 
all_months$=make_all_months$ 
res= b$ INSTR all_months$ 
END IF 
res=(res+2) /3 
b$=res: IF res<« 10: b$="0"&b$ 
IF dflag%:RETurn a$(10 TO 11)&". "&b$&". "&a$(1 TO 4) 
RETurn a$(1 TO 4)&". "&b$&". "8a$(10 TO 11) 
END DEFine make_date$ 


DEFine FuNction find_mydrive$ 
REMark this finds my primary QL hard disk 
LOCal 1p%,chan%,mydrive$ 
DATA_USE "" 
FOR 1p%=1 TO 8 
mydrive$='win' &1lp%k'_! 
chan%=FOP_DIR (mydrive$) 
IF chan% 0:CLOSE#chan%:RETurn mydrive$ 
END FOR 1p% 
chan%=FOP_DIR('flpi_') 
IF chan% 0:CLOSE#chan%:RETurn 'flpi_'! 
RETurn "" 
END DEFine find_mydrive$ 


So, das war's nun aber wirklich... 
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Printer Control Codes - 
a dreaded Subject - Part 3 


Dilwyn Jones 


How do Printers cope with the 
different Character Sets of each 


Country? 

These are usually referred to as the National Cha- 
racter Set for the country in question, where a 
few characters differ from country to country. 
Common sources of problems include accented 
characters, the hash symbol and currency sym- 
bols such as the British Pound Sterling symbol. 
Most printer manuals include a page which ex- 
plains (usually by means of a table) which cha- 
racters vary from country to country, and what 
they look like in each of the National Character 
Sets. Many European countries have their own 
character set - French, Spanish and Swedish, for 
example. Even English is not immune from this, as 
the U.S.A. and Britain have their own character 
sets. Don't get the idea that there are completely 
different character sets for each country, only a 
few characters vary within the code range 32 to 
127, usually 35 and 96 cause English users the 
biggest problem. Software usually gets around 
this by allowing the user to specify Preamble 
codes codes which are sent to the printer to set 
any options applicable to the entire printout, such 
as choosing which country’s character set to use. 
In practice, if writing programs for your own use, 
you'll have your printer set to the correct national 
character set for your country, so this problem 
does not arise. 

A slightly bigger problem may be that the charac- 
ters and their codes on the QL may not corres- 
pond exactly with the character set on a printer. 
To get around this, programs like Quill use Trans- 
late sequences. This treats the character sets on 
the QL and the printer as though they were two 
different languages and does any swapping of 
characters, or even switching character sets, ne- 
cessary to get the characters to print as required. 
For example, a Spanish QL user wishing to en- 
sure that his/her QL prints a British pound symbol 
would have to include as a translation a sequence 
of characters which says which of the Spanish QL 
character set represents a pound, then the con- 
trol codes needed to switch the printer to a Bri- 
tish character set, then send which character 
code prints as a pound symbol in the English 
character set, then finally sends the control codes 
to switch back to the normal Spanish character 
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set. Where the character set includes the required 
character, but it has a different code to that used 
on the QL, it is simply a matter of saying ‘every 
time you need to print this, send this code in- 
stead, or something like this, assuming the cha- 
racter to be printed is in the string variable a$: 
IF CODE(a$) = 96 THEN PRINT #3,CHR$(35); 
:ELSE PRINT #3,a$; 
A simple way to build up a translate table on the 
QL is to use a SELect construct. The characters 
which need to be changed to print can be given 
their own = statement, while the =REMAINDER 
clause prints the rest unaltered. Again, the charac- 
ter to be printed is in a$, our routine translates it 
into a character held in p$ which is then printed. 
LET ede = CODE(a$) : LET p$ = '' 
SELect ON ede 

= 35 : p$ = CHR$(96) 

= 96 : p$ = CHR$(137) 

= REMAINDER : p$ = a$ 
END SELect 
PRINT #3,p$; 


Some Printer Commands specify 
Names like NUL, BEL, ESC etc. 


What does this mean? 
It's an old method of giving 
names to important control 
codes. While it is not vitally im- 
portant you learn these names 
and their meanings, you may 
find it useful from time to time 
to have a table that lists which 
code corresponds to which 
names for the codes 0 to 31. If 
you think you have seen these 
before, you may have noticed 
them in your printer manual 
(many list them) or when using 
INSTALL_bas to create a Quill 
printer driver which includes 
codes 0 to 31 (see table 1. 


0) 
1 
2 
2 
4 
y) 
6 
7 
8 
9 


Before embarking on writing 
programs which need to work 
with many types of printers, 
you may find it a useful exer- 
cise to create a spreadsheet 
listing the equivalent codes for 
the various functions on all the 
printer types you encounter 
and become familiar with. You'll 
be surprised to find that the 
various command sets do 
have some common ground, 
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TF Services 


superHermes 
A major hardware upgrade for the QL 

* All Hermes features (see below for list) PLUS full 19200 
throughput on serl/ser2 not affected by sound 

* IBM AT kevboard interface (plus foreign drivers) 

* HIGH SPEED RS232 industry standard two-way serial port. 
4800cps throughput (supergoldcard - gtpi - zmodem) at 
§7600bps 

* THREE low speed RS232 inputs (1200 to 30bps) Driver for 
SERIAL MOUSE supplied. Other uses include RTTY/ 
graphics tablet ete 

° THREE spare I/O lines (logic) with GND/+5V 

® Capslock/scrollock LED connector 

* Turbo/keylock connectors 

|p. 1.5K user data permanently storeable in EEPROM 

| | All this on a professional board about twice the size of 


the 8049 co-processor it replaces 
Cost (including manual/software) £90 (£92/£87/£90) 


IBM AT UK layout Keyboard £22 (£24/£23/£27) 
Serial mouse £11 (£13/£12/£14) 
Capstock/scroliock LED £1 (£1.50/£1/£1.50) 
Keyboard or mouse lead £3 (£3.50/£3/£3.50) 
High specd serial (ser3) lead £4 (£4.50/£4/£4.50) 


Hermes available for £25 (£26/£24/£27) Working ser1/2 
and independent input, debounced keyboard & keyclick. 


superHermes LITE 


All Hermes features (see above) + an IBM AT 
keyboard interface only. Entry level superHermes. 
Cost (incl keyboard lead)...£53 (£55.50/£51/£53.50) 


MINERVA RTC (MKII) + battery for 256 bytes ram. 
CRASHPROOF clock & I°C bus for interfacing, Can 
autoboot from battery backed ram. Quick start-up. 


The ORIGINAL system operating system upgrade 
OTHER FEATURES COMMON TO ALL VERSIONS 


DEBUGGED operating system/ autoboot on reset of power 
failure/ Multiple Basic/ faster scheduler- graphics (within 
10% of lightning) - string handhing/ WHEN ERROR/ 2nd 
screeny TRACE/ non-English keyboard drivers/ “warm” 
fast reset. V1.97 with split OUTPUT baud rates (+ Hermes) 
& built in Multibasic. 

First upgrade free. Otherwise send £3 (+£S5 for manual if requd). 

Send disk plus SAE or two IRC's 


MKIL...£40 (£41/£40/£43) MKIIL...£65 (£66/£63/£67) 


OL REPAIRS (UK only) 


Fixed price for unmodified QLs. excl microdrives. QLs 
tested with Thorn-EMI rig and ROM software 


£27 including 6 month guarantee 


Prices include postage and packing (Airmail where applicable). Prices are: UK (EC/Europe outside EC/Rest of world). 
UK address, debit card/Mastercard/Access/Eurocard/postal arder or CASH! (No Eurocheques). SAE or IRC for full list and details 


29 Longfield Road, TRING, Herts. HP23 4DG 


Vel: 01442-828254 


OL RomDisg 


Up to 8 mbyte of flash memory for the QL 

A small plug in circuit for the QL°s ROM port (or 
Aurora) giving 2, 4 or 8 mbytes of permanent storage 
- it can be thought of as a portable hard disk on a card, 
and reads at some 2 mbytes per second. 

Think of it - you could fully boot an expanded QL. 
including all drivers/SMSQ etc off RomDisq at hard 
disk speed with only a memory expansion needed. 


£39 (£41£37/£40) 
£65(£66/£63/£67) 
£98 (£100/£95/£99) 
£3 (£3.50/£3/£4) 


MPLANE 


A low profile powered backplane with ROM port 


A three expansion backplane with ROM port included for 
RomDisq etc. Aurora can be fitted in notebook case and 
powered off single 5V rail - contact QBranch for details. Two 
boards (eg Aurora and Gold Card/Super Gold Curd/Goldfire 
fixed to base. Suitable for Aurora (ROM accessible from 
outside) & QI. motherboard in tower case. Specify ROM 
facing IN towards boards, or OUT towards back of case. 


2 mbytes RomDisq 
4mbytes RomDisq 

8 mbytes RomDisq 
Aurora adaptor 


COSt.......cesseecersevesssesene £34 (£36/£33/£35) 


I2C INTERFACES 
Connects to Minerva MKII and any Philips PC bus 


Power Driver Interface 16 I/O lines with 12 of these used to 
control 8 current carrying outputs (source and sink capable) 

2 amp (for 8 relays, small motors) ............ £40 (£43/£38/£44) 

4 amp total (for motors etc) £45 (£48/£43/£50) 

Relays (8 3a 12v 2-way mains relays (needs 2a power 
ANVER) iin ste eenthe se Sates .. £25 (£28/£23/£27) 

Parallel Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required... £25 (£28/£23/£27) 

Analogue Interface Gives eight 8 bit analogue to digital 
inputs (ADC) and two 8 bit digital to analogue outputs 
(DAC). Used for temperature measurements, sound 
sampling (to 5 KHz), x/y plotting... £30 (£31 50/£29/£30) 

Temp probe (-40°C to +125°C) £10 (£10. SO/EL0/E11) 

Connector for four temp probes £10 (£10. SO/ELO/EN1) 

Data sheets ...........0cccc cence cette eeaeeees £2 (£2.50/£2/£3) 

Control software & manual (for all I/F).. £2 (£2.50/£2/£3) 


OL SPARES eos 


£12 (£12. S0/£12/£13.50) 

£3 (£3.50/£3/£4) 
Circuit diagrams.............. £3 (£3 SU/E3/£4) 
68008 cpu or 8049 IPC £8 (£8. 50/£7.50/£9} 
8301/8302 or JM ROM or serial lead . £10 (£1).50/£10/€11) 
Power supply (sea mail overseas) £12 (£17/£16/£21) 


Other components (sockets etc) also available 


Payment by cheque drawn on bank with 


Keyboard membrane 
1377 PAT 


Fax/BBS: 01442-8282 


tonya firshman.demon.co.uh — http:/Ayvww. firshman.demon.co.uk — 
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differences too, especially in the way they handle 
text sizes, character definitions and how they 
print graphics. 

| hope you will have seen that programming for 
printers is not the easiest of subjects to master, 
and that the insights offered will give you some 
insight into how difficult a programmer's life can 
be trying to cope with all the possibilities his/her 
program will have to deal with. 

Finally, | have included a table below, listing equi- 


valent codes for the four types of command set 
've come across. The letter 'n’ is used to denote 
where a number has to be specified, e.g. the 
number of the font to be used. Where | have left a 
given entry blank, or marked it as n/a it either 
means the facility does not exist in the command 
set, or that simply | don’t know what the control 
code is (even someone who's been using a QL 
since they first came out hasn't had to learn them 
alll} 


EPSON IBM CANON HEWLETT-PACKARD 
BACKSPACE 8 8 8 8 
LINEFEED 10 10 10 10 
CARRIAGE RETURN 13 13 13 13 
FORMFEED 12 12 12 42 
TAB ACROSS 9 9 9 9 
BOLD ON 27,69 27,69 27,69 27,40, 115,51, 66 
BOLD OFF 27,70 27,70 27,70 27,40,115,48, 66 
2-STRIKE ON 27,71 27,71 ea Al n/a 
2-STRIKE OFF 27,72 27,72 27,72 n/a 
ITALICS ON 27,52 28,52 n/a 27,40,115,49,83 
ITALICS OFF 27,53 28,53 n/a 27,40,115,48,83 
UNDERLINE ON 27,45,1 27,45,1 27,45,1 27, 38, 100,49, 68 
UNDERLINE OFF 27,45,0 27,45,0 27,45,0 27,38, 100,64 
NLQ PRINTING 27,120,1 27,120,1 n/a 27,40,115,50,81 
DRAFT PRINTING 27,120,0 27,120,0 n/a 27,40,115,49,81 
CHARACTER SET n 27,82,n 27,82,n n/a 27,40,n1,n2 
COLOUR n 27,114,n 27,114,n 27,91,77,ni,n2,m  27,42,118,<colour ,83 
FONT n 27,107,n 27,107,n n/a 27,40, 115,ni,n2 
RESET PRINTER 27,64 27, 64 n/a 27,69 
CONDENSED PRINT ON 15 15 15 27,40, 115,49, 54,46, 54,55,72 
CONDENSED PRINT OFF 18 18 18 27,40,115,49,48,72 
DOUBLE WIDTH ON 14 or 27,87,1 14 or 27,87,1 14 or 27,87,1 n/a 
DOUBLE WIDTH OFF 20 or 27,87,0 20 or 27,87,0 20 or 27,87,1 n/a 
ELITE (12 epi) ON ba hig: 27,58 27,58 27,40,115,49, 50,72 
ELITE OFF (Pica on) 27,80 18 18 27,40,115,49,48,72 
SUBSCRIPT ON 27,83,1 27,83,1 27,83,1 27,40,115, ,45,49, 85 
SUPERSCRIPT ON 27,83,0 27,83,0 27, 83,0 27,40, 115,43,85 
SUB/SUPER OFF 27,84 27,84 27, 84 27,40,115,48,85 
PROPORTIONAL SPACE ON 27, 112,1 27,80,1 27,80,1 27,40, 115,49, 80 
PROPORTIONAL OFF 27,112,0 27,80,0 27,80,0 27,40, 115,48, 80 
LEFT MARGIN n 27,108,n 27,108,n }27,88, left, 27, 38,97, «margin ,76 
RIGHT MARGIN n 27,81,n 27,81,n } right 27, 38,97, «margin ,77 
PAGE LENGTH (lines) 27,67,n 27,67,n 27, 67,n 27,38, 108,< lines» ,70 
BOTTOM MARGIN (lines)  27,78,n 27,78,n n/a 27,38, 108,<lines> ,69 
TOP MARGIN (lines) 27,99,n 27,99,n n/a n/a 
UNIDIRECTIONAL PRINT 27,85,1 or 27,85,49 27,85,1 27,85,1 27,38, 107,48, 87 
BIDIRECTIONAL PRINT 27,85,0 or 27,85,48 27,85,0 27, 85,0 27,38, 107,49,87 

¢ > ‘ 
Assembly Language Programming — What's Going On? 
Last issue was not a tutorial 


- Part 6 


Norman Dunbar 


Here we are in part 6 of the 
articles on Assembly language. 
ls anyone still with me? This 
article is being written at home, 
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on my own PC (shock horror!) 
As | have not been sent off to 
visit customers this week 
next week, who knows? — 


article, it was a part of QLIdis - 
the project. This will be the 
manner of things from now on. 
There will be an article on as- 
sembly language followed by 
the next instalment of QLdis. 
This saves me from having too 
much space in every issue, it 
saves there being masses of 
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assembly code each time - some people don't 
have any interest in assembler - and it saves me 
having to write two articles each time! 


Oops, bugs already 

Well now. Part one of QLidis has a nasty bug in it 
and for this | apologise. Strangely enough, it is 
related to a letter from George Gwilt - see below 
- but can cause QLIdis to crash the QL when no 
printer device is specified. The following changes 
MUST be made to INIT_ASM: 

First, at label GET_PRINTER add the two lines 
after ‘bsr input’: 


bsr input ; Wait for user input 


tst.w dd 
beq.s  clr_ser 


; Check user specified a device 
; No device specified 


Finally, add a label (clr_scr) to the following line: 
els_ser  movea.] con_id2(a4) ,a0 ; Output console id 
bsr els ; Clear sereen 


That is all there is to it. If you didn't enter a printer 
name, the code will attempt to copy 65,536 
bytes of rubbish all over your QL’s memory 
which will more than likely cause it to crash or 
lock up. The following explains the problem. 


Matters Arising .... 

In issue 6 of volume 3, there is a letter from 
George Gwilt who points out a few things about 
DBRA type loops and my comments on how 
they should be written. If you take a look at my 
article in issue 5 of volume 3 (pages 25 and 26) 
you will see two examples of how to write a 
DBRA type loop. 

George points out that while example 2 is better 
in terms of readability, there could be problems if 
the value in the counting register is zero. As 
George says, the method of subtracting one from 
the counter then dropping into the loop could 
lead to a loop that performs 65536 times rather 
than zero times - how can this be? 

Ok, this code is called from another part of some 


program with the loop counter in DiW: 
loopy_bit SUBQ.W #1,D1 


loop BSR do_something 
DBRA = D1, loop 
RIS 


Why would this fail, or more to the point, when? 
Imagine if DIW was 1 then the above subroutine 
called, what would happen? Well, remember how 
the DBcc instructions operate in three parts: 

First, the condition is tested to see if it is true. In 
this case, the condition is ignored as the DBRA 
instruction will always loop - unt... 
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Second, the lowest word of D1 is decremented 
by one. Then tested to see if it is -1 yet. If it is, 
the loop is not taken and the RTS is executed. 
Third, If the counter register is not -1 then the 
loop is taken to the code at label ‘loop’. 


So, with Di set to i on entry, the loop is carried 
out once, then terminated. No worries here. What 
happens if D1 was set to zero on entry? 

D1 would be set to -1 by the SUBQW instruction, 
then the code at ‘do_something’ would be 
executed - but we had a zero count so this is 
wrong straight away. On return, the condition test 
would be checked - but there is no condition 
with DBRA. Then Di would be decremented to -2 
(ll), This does not equal -1 so the branch would 
be taken and taken again and again until Di once 
more became -i. Then it would have been 
executed 65,536 times too many! 


So beware. | can highly recommend the following 


code instead: 
loopy_bit BRAS  skippy_bit 
loop BSR do_something 
skippy_bit DBRA  D1,loop 
RTS 


Which will always avoid the above problem. Now 
if D1 was zero, it will be decremented to -1 when 
it skips to the DBRA instruction and this will cor- 
rectly terminate the loop. 

So keep in mind the fact that the loop stops 
when the counter reaches -i and that the 
counter is decremented before testing for -1. 
Also bear in mind that George is a far better as- 
sembler programmer than | am - if he says some- 
thing, believe it!! (George wrote the GWASL as- 
sembler given away on the cover disc recently.) 
So now you know why the bug in INIT_ASM oc- 
curs, and why | have changed the code to fix it 
As an exercise - how else could | have fixed it - 
see the end of the article for the answer: No 
cheating! 

Thanks for pointing out the potential problems 
George. 


A Few Quickies! 

This section deals with a few instructions that 
the QL programmers rarely, if ever use. These 
instructions are: 

CHK 

ILLEGAL 

RESET 

RTR 

STOP 

TRAPV 
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The CHK instruction has the format: 
CHK «ea» ,Dn 
and causes an exception to be generated if the 
value in DnW is less than 0 or greater than the 
value in the effective address. On a normal QL 
this is totally ignored - the exception that is - 
however, with a bit of deft QDOS programming, 
this can be redirected to your own routine. | have 
never seen this done in any programs - yet! By 

the way, the value in the effective address is a 

two's compliment signed number The flags 

affected are: 

N - set if DnW is less than zero, cleared is DnW 
is greater than the effective address value. 
Otherwise it is undefined. 

- undefined. 

- undefined. 

- undefined. 

- unaffected. 


xO <N 


The format of the ILLEGAL instruction is quite 
simply: 
ILLEGAL 

and all it does, by default, is to crash the QL! It 
can however be redefined to do something 
useful as with the CHK instruction. (We may get 
around to covering QDOS stuff in a much later 
episode) This instruction also causes an excep- 
tion to be generated. No condition codes are 
affected. 


The RESET instruction has the format: 
RESET 

and causes the ‘reset’ line to be ‘asserted’ 
causing all external equipment interfaced to the 
processor to be reset. On the QL, it actually 
causes a system reset - similar to you pressing 
the reset switch. This instruction will only be exe- 
cuted if the processor is running in supervisor 
mode, in user mode, all that happens is that the 
program counter is incremented by 2 to skip 
over this instruction. No flags are affected. 


RTR has the format: 

RTR 
and is actually equivalent to the following two 
instructions: 

MOVE (A7)+,SR 

RTS 
However, the MOVE (A7}+,SR instruction is privi- 
leged on the 68000 so can only be run in super- 
visor mode. Using RTR is not privileged so the 
two instructions can be combined as one. This is 
a useful instruction for subroutines where the 
Status register is saved on the stack on top of 
the return address. The following code is an 
example. 
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start BSR example 
} Wore code here 


example MOVE SR,~(A7) 
; do some code here 
RIR ; Unstack the status code 


; Stack the status register ete 


What happens when a subroutine is called is that 
the return address is placed on the stack and 
then the subroutine jumped to. In this example 
the status regisetr is placed on the stack as well. 
This is a word sized SR on top of a long sized 
Program Counter 

The subroutine carries out various bits of proces- 
sing - probably trashing the status codes etc as it 
does so. At the end, the old SR is put back into 
the SR and the return address placed in the PC 
by the RTR instruction. 

It is a quirk of the 68000 that the instructions to 
move data from the SR are not privileged while 
those that move data into the SR are privileged. 
This is a handy way around this restriction. 
Obviously, the various flags in the SR are 
changed according to the word removed from 
the stack EXCEPT FOR THE SUPERVISOR BIT 
WHICH IS UNCHANGED! 


The STOP instruction has the format: 
STOP #data 

and causes the processor to put the word of 
data into the SR, increment the PC to point at the 
instruction following this one, and then the pro- 
cessor just stops - until any trace, interrupt or 
reset exceptions are generated. The interrupt 
must be higher that the current processor inter- 
rupt level to have any effect. The flags are set 
according to the data word in the instruction. 
Theis is another privileged instruction and is the 
processor is in user mode, and a privilege viola- 
tion exception will be generated. 


The TRAPV instruction has the format: 

TRAPV 
and is used to cause an exception if the V flag is 
set. (Overflow flag). Normally this is ignored on a 
QL but can be redirected with the afore men- 
tioned QDOS jiggery pokery to do something 
useful. No flags are affected. 


A Few Little Bits ... 
This section deals with instructions that check, 
change, set or otherwise fiddle about with the 
individual bits in a register or memory adaress. All 
of these instructions have a similar format, which 
1S: 

Bxxx Dn,<effective address> 

Bxxx #data,<effective address> 
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‘CAMBRIDGE I 


MOBILE: 07808 576118 ye cee nieeae 
E-MAIL: WNR@COMPUSERVE.COM Buckinghamshire SL9 ONB 


THE DEAL PORTABLE COMPANION FOR THE QL PC AND MAC] 


THE CAMBRIDGE Z88 A4 NOTEBOOK 


WITH BUILT-IN WORD PROCESSOR, SPREADSHEET, 
DATABASE, BASIC, CALCULATOR, CLOCK, ALARM, 
CALENDAR & VT52 TERMINAL. 
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BRIDGE 288 | E4-128K . 
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32k RAMPACK ................08. 
128k RAMPACK ................4. 
32k EPROM PACK ................. 
128k EPROM PACK .................. 
256k EPROM PACK ................. 
EPROM ERASER .................005 


PARALLEL PRINTER LEAD............ 
SERIAL PRINTER LEAD 
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TOPPER (PROTECTIVE COVER) ............. 0.0. e cece eee cee een eee | i Pree $16 
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FILE TRANSFER TO OTHER COMPUTERS 


PCLINK KIT (For PCs) 
288 TO MAC KIT 
288 TO BBC KIT 


POSTAGE UK UP TO £5. EEC £15. USA £20. OTHER COUNTRIES £30. 


ALL THE STOCK IS WARRANTIED FOR 80 DAYS. IN THE EVENT OF REPLACEMENT 
BEING ARGREED, BUT THE ITEM BEING OUT OF STOCK AT THE TIME, A REFUND 
WILL BE MADE PROVIDED THE ITEM IS RECEIVED IN GOOD CONDITION. 


QL & PC COMPUTER USERS WILL FIND THE CAMBRIDGE Z88 ESPECIALLY USEFUL FOR WORK AWAY FROM 
THE DESKTOP. WITH TRANSFER PROGS DATA CAN BE SAFELY EXCHANGED WITH THEIR DESKTOP SYSTEM. 


W.N. RICHARDSON & CO CONTINUES TO PROVIDE FULL SPARES AND 
SERVICES FOR SINCLAIR COMPUTERS, OL & THE CAMBRIDGE 288 
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They all TEST the bit about to be fiddled with 
BEFORE fiddling with it The flags are set accor- 
ding to the state of the bit BEFORE the fiddling 
was done. Remember this important fact. The bit 
number is either supplied in a data register or as 
immediate data. 

When the bit number is being processed the 
68000 makes sure that if is in range for the 
actual data being operated on. If the effective 
address is a data register (you cannot use these 
instructions on address registers) then the actual 
bit number is bit number MOD 32. 

lf a memory address is being manipulated, the 
range is adjusted to be 0 to 8 using bit number 
MOD 8. 

The flags are all unaffected except for the Z flag 
whch takes the state of the ‘previous’ value of 
the bit being manipulated. 

The instructions are: 


BCHG or Bit Change, which sets the Z flag to 
the bit affected and then changes the bit from a 
1 to a zero or from a zero to a 1. 


BCLR or Bit Clear which always puts a zero into 
the affected bit. 


BSET or Bit Set, which aslways puts a 1 into the 
affected bit. 


BTST or Bit Test, which sets the Z flag to the 
state of a bit. If the affected bit is a zero, the Z 
flag is set to show this. If it was a 1 then the Z 
flag will be reset to show this. 


This family of instructions are very useful when 
using a byte, word or long to hold 8, 16 or 32 
different flags in a program as each one can be 
tested, set or reset individually and this takes 
place within QDOS in a number of places. 

As a small example, imagine you were writing a 
program and you needed to check when the 
user typed an UPPERCASE character Rather 
than checking every one for ‘A’ and ’Z’ (which 
only apply to the English language remember, 
you could set up a bitmap table of 256 bytes and 
have a single bit represent uppercase, another 
could be for numeric, another for control/ 
unprintable characters etc etc. As each character 
was read, index into the table on that character 
code and check the appropriate bit. 


3 

; Some code above to get a character from the user/file ete 
; Assume D1, holds the character code. Top 8 bits are zero. 
; Assume that bit 0 is the uppercase/lowercase flag bit. 


3 
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check LEA bitmap, Al ; Al is address of the bitmap table 


BIST #0,(A1,D1.W} ; Is it uppercase ? 
BEQ.S upper ; Yes, if bit zero is set 


lower ; process lowercase here 


upper ; process uppercase here 


bitmap ; 256 bytes go here, one for every character. 

The bitmap table has a single byte for each avai- 
lable character 0 to 255 and sets the bits in each 
one according to the character type. In this 
example we use bit 0 for upper/lower case only 
so wastes 7 bits of each byte, but remember. 
these extra bits could be used to define control 
characters, digits, hex digits, alpabetic, alpha-nu- 
meric, punctuation etc. 

The advantage to this method is that different 
tables can be loaded for different languages. The 
disadvantage is that the program will be slightly 
longer because of the need to store the table. 


Testing, Testing. 
In QLdis, | have used the TST instruction to com- 
pare a value against zero. This is a useful 
instruction and replaces CMPlsize 40.Dn. The 
format is: 

TST.size «effective address> 
The flags are set differently from CMP! as well as 
the V and C falags are always cleared to zero. 
CMPI doesn't do this. The flags are 
N is set if the operand is negative, reset if positive. 
Z is set if the operand Is zero, reset otherwise. 
V is always Cleared. 
C is always cleared. 
X is not affexted. 


Why use TST when CMP! will do as good a job? 
Well it is all down to three things really: 

Do you want to use TST or CMPI #0? 

Do you need to preserve the V and C flags? 
TST is quicker TST takes 8 clock cycles while 
CMPI takes 16, 24 or 26 depending on the ope- 
ration. Both take the same time to work out the 
effective address calculation, but TST also needs 
fewer read cycles - 2 - while CMPI needs 4 or 6. 


TAS is another testing instruction, which actually 
does two separate operations in one single 
UNINTERRUPTABLE step. The format is: 

TAS «effective address> 
The size is always byte and need not be 
specified. The flags affected are: 
N is set if bit 7 of the operand was set, otherwise 

cleared. 

Z is set of the operand was zero, Reset 

otherwise. 
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V is always cleared. 
C is always Cleared. 
X is not affected. 


The instruction reads the byte at «effective 
addresschecks bit 7, sets the flags and then sets 
bit 7. The modified byte is written back to the ef- 
fective address. It is similar to the folowing code: 
BIST #7,<effective address> 
BSET #7,<effective address> 


Obviously there are two instructions here which 
alter the flags, however, TAS does it in one. The 
main point about TAS is that it is a single instruc- 
tion which cannot be interrupted once it has star- 
ted. This makes it useful for multi tasking or multi 
processor systems where any sequence of in- 
structions can be interrupted. 

In the above example, the system could be 
interrupted by a floppy disc I/O request between 
the end of the BTST and the start of the BSET 
This could result in a new value being placed into 
‘effective address> by the interrupting routine. 
The BSET would then possibly give the wrong 
results after it executed. 

This will not ever happen with the TAS instruction. 
lf the above code was being used in a multi 
processor system to synchronise access to 
some system resource, the two _ instructions 
could lead to mis-synchronisation. Using TAS 
would not allow this to happen. 


Finally in this section, although not quite a testing 
instruction, is the ‘set according to condition 
code’ instructions. These have the format: 

See «effective address> 


The size is always byte and is not specified. 
What happens is that the condition code is 
tested, and if found to be true, the byte in 
‘effective address> is changed to be all ones 
otherwise it is changed to be all zeros. The 
condition codes are as for Bcc, DBcc 

This sets a memory address or a byte in a 
register to 255 or 0 for True or false. On QDOS 
systems we tend to use 1 for true and 0 for false. 
How can we quickly change from 255 and zero 
to 1 and zero? 

The answer is quite simple, 255 is an unsigned 
number but if it was signed, it would be -1. Simply 
follow the Scc instruction with NEG.B as follows: 


; Do some code here to set condition flags. 


SMI Di 
NEG.B ODL 


; Set D1.B to $FF if 'something' was minus 
; D1.B now is $01 or $00 which is what we want ! 
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And Finally? 

| think we are just about finished covering all 
those boring instructions, but we stil have a 
couple to do yet. These don't really fall under 
any of the headings | have used up til now, so | 
simply add them on at the end! 


On the QL, assembly language programs must 
be written so that they are ‘relocatable’. All this 
means is that you must not assume that your 
code will always run from a specific address but 
that it could run from ANY address. 
The LEA instruction which has been used quite a 
lot in QLIdis already allows just this to happen. 
This has the format: 

LEA «effective address>» ,An 


None of the flags are affected. So, a quick bit of 
revision, what is the difference between the 
following two instructions? 

MOVE «effective address) ,A1 

LEA «effective address» , AL 
MOVE calculates the effective address and reads 
its contents into Al while LEA calculates the 
effective address and puts that into Al, not its 
contents. 
This allows position independant code to be 
written and is a very much used instruction in 
QDOS programs. It also helps get around the fact 
that PC relative mode addressing !s forbidden as 
the destination in a MOVE instruction. The fol- 
lowing code will not assemble: 

MOVE.L DO,buffer(PC) 
But this will, and does what is required: 

LEA buffer, Al 

MOVE.L DO, (At) 


There is a similar instruction called Push Effective 
Address and this has the format: 
PEA «effective address> 


and simply calculates the effective address and 
puts it onto the stack. The stack pointer is prede- 
cremented and none of the flags are affected. All 
this is very similar to the following: 


LEA some_code,Al  ; Get the address of label some_code into Al 
MOVE.L A1,~(A7) ; Stack it 


But why would you use PEA to do this rather 
that the above, and what use is it afterwards? 
Apart from it being shorter to code - one 
instruction instead of two - it doesnt require a 
register to be used. The address is on the stack, 
SO what next? 


Think about these instructions: 
PEA some_code,Ai  ; Get the address of label some_code into Al 
RIS 
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What has just happened? The address of the 
routine at ‘some_code’ has been placed on the 
Stack, then when RTS is executed, it returns 
control to the address WHICH IS ON THE STACK. 
So this is another way of doing this: 


LEA some_code, AL 
JSR (a1) 


Why would you use this? | have absolutely no 
idea! But it is important to note that the first 
method will NEVER return to the address after 
the RTS because there is no return address on 
the stack. The second and ‘normal method will 
return to the address after the JSR (Ai) as the 
JSR stacks its return address. 


The next and final two instructions are seldom 
used in normal assembler programs on the QL - 
at least, | have never seen one in all my years of 
reading & writing code. They are probably used 
most by the code generated by various compi- 
lers that exists for the QL so that ‘stack frames’ 
can be built and parameters passed to sub-rou- 
tines created by the compiler The two instruc- 
tions are LINK and UNLK and they do not affect 
any flags. 


The LINK instruction has the format: 
LINK An, #displacement 

and carries out the following actions: 

First the stack pointer is decremented by 4. Then, 
the current contents of An are copied onto the 
Stack. Then the stack pointer is copied to An. 
Finally, the stack pointer has the displacement 
ADDED to it. 


UNLK has the format: 

UNLK An 
and carries out the reverse of the LINK instruc- 
tion in that the stack pointer is reloaded from An, 
then An is reloaded from the value on the stack 
and the stack pointer is incremented by 4. 
Assuming that A7 is currently holding value 
$20000 and A4 is holding $00123456 the the 
sequence of instructions: 


LINK A4,~$10 
do something here ... 


UNLK m4 
will result in the following: 
A7 will be decremented by 4 to $ifffc 
A4 will be stored at this address ($1fffc) 
A4 will then have $ifffc loaded into it 
A7 will have $10 subtracted (because we sup- 
plied a negative displacement) to give $iffec. 


This means that the code between the LINK and 
UNLK instructions can use the free space bet- 
ween (a7) and -4(A4) for working space. There 
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are 16 bytes available for use between these 
addresses and they can be accessed using A4 
as a ‘stack frame pointer’ and using negative off- 
sets. 

Once the UNLK instruction is reached, we must 
not have changed the value in A4 or all hell will 
break loose! 

A7 is set to the value in A4 which should be 
Slfffc. A4 will be set to the long word at O(a7) 
which is where its original value of $00123456 
was stored by the LINK instruction. A7 will have 4 
added to it giving the original $20000 that we 
had when the LINK was executed. 


So Here We Are! 

Well, that is the end of the most boring part of 
this series. | apologise for the dreary nature of 
the previous few episodes but! can’t think of any 
other way to make a micro-processor's instruc- 
tion set interesting reading! 

We have now covered all the 68008 instructions 
and the time has come to start putting the infor- 
mation into practice. However, when | was lear- 
ning all about 68000 assembly language, there 
were a few concepts that gave me troubles - and 
| still have to look them up even today! 

To make things a bit easier for you, here are my 
bug-bears and an explanation of how to get 
around them. 


Comparing Things 

Comparing registers or registers and values etc 
always gives me problems. | can never re- 
member which flags are set or which ones to 
check when using signed or unsigned values. 
The following should hopefully make life easier 
Remember, when using the CMP instruction, you 
should read it as ‘if destination condition source’. 


Equality checks - signed and unsigned are the 
same. 


CMP.L = DO,Di 

BEQ.S equal ; if dl = dO goto equal. 
or 

CMPI.L #10,D1 

BEQ.S equal 3 if dl = 10 goto equal. 


Non equality checks - signed and unsigned are 
the same. 
CMP.L DO,DL 
BNE.S  not_equal 
or 
CMPI.L #10,D1 
BNE.S not_equal ; if di «> 10 goto not_equal. 


; if dl © d0 goto not_equal. 


Greater than - unsigned only. 
CMP.L = DO,Di 


BHI.S greater ; if D1» DO goto greater. 


QL foday 


or 
CMPI.L #10,D1 
BHI.S greater ; if Dl» 10 goto greater. 
Greater than - signed only. 
CMP.L = DO,Dt 
BGT.S greater 
or 
CMP.L  #-5,D4 
BGT.S greater 


; if Di» DO goto greater. 


; if Dl» -5 goto greater. 


Greater Than or Equal - unsigned only. 
CMP.L = =DO,DL 

BCC.S greater_eq ; if (D1 »= DO) goto greater_eq 

or 


OMPI.L #5,D1 
BCC.S greater_eq ; if (D1 >= 5) goto greater_eq 


Greater Than or Equal - signed only. 
CMP.L = BO,D1 
BGE.S greater_eq ; if (Di >= DO) goto greater_eq 
or 
CMPI.L #-5,D1 
BGE.S greater_eq ; if (D1 >= -5) goto greater_eq 


Less than - unsigned only. 


CMP.L =DO,D1 

BCS.S less ; if D1 « DO goto less 
or 

CMPILL #5,D1 

BCS.S less ; if Di« 5 goto less 


Less than - signed only. 


CMP.L = D0, D1 

BLT.S less ; if Di « DO goto less 
or 

CMPI.L #-5,D1 

BLI.S less ; if Di« ~5 goto less 


Less than or equal - unsigned only. 
CMP.L = DO,Di 
BLS.S  less_eq 

or 
CMPI.L §#10,D1 
BLS.S —Less_eq 


; if Di «= DO goto less_eq 


3 if Di «= 10 goto less_eq 


Less than or equal - signed only. 
CMP.L = D0,D1 
BLE.S less_eq 

or 
CMPI.L #10,D1 
BLE.S less_eq 


Signed Numbers being MOVEd 
Rememeber also that flags and conditions are 
set when data is MOVEd into data registers, or 
after arithmetic etc, so the following are valid as 
well. Obviously, the following code will not work 
correctly if you find this in a real program - don't 
use it! 


; if D1 «= DO goto less_eq 


; if Di «= 10 goto less_eq 
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MOVE ‘01,00 

BEQ.S Diis zero 
BNE.S D1_is_not_zero 
BEE.S D1_is_Q_or_more 
BPL.S Di_is_0_or_more 
BGT.S DiLis_t_or_more 
BLE.S Dt_is_0_or_less 
BLT.S Di_is_negative 
BMI.S Di_is_negative 


Answer To INIT_ASM Bug Fix Exercise. 


Have you figured it out then or are you cheating? 


; Copy D1 to DO & set flags accordingly 
; DL is now zero 

; D1 ig not zero 

; Di is now zero or greater 

; Ditto 

; Di is now greater than zero 

; Di is now less then zero 

; Di is now less than zero 

; Ditto 


The fix | made explicitly checks the size of the 
printer device name and if zero skips over the 
‘move to storage’ part of the code. The other fix 
is to change the code as follows: 

First, change the line at GET_PRINTER from 
‘subqw "1 dl’ to ‘bras move_byte’. Second, add 
a label (MOVE_BYTE) to the line under 
MOVE_PRNAME. The new GET_PRINTER code 
looks like this: 


get_printer lea print_dev, al ; Our prompt 
bsr prompt ; Print it 
bsr input ; Wait for user input 
lea pr_dev,a0 ; Storage for printer name 
move.w di, (a0)+ ; Save filename length 


bra.s  move_byte ; Move printer to safe storage 


(Ai)+, (A0)+ 
di,move_prnane 


; Move a single character 
; And the rest 


move_prnate move.b 
move_byte  dbra 


Next issue, QLTdis part 2 where | explain how 
each instruction will be ‘cracked’. See you there. 
a 


Adventures on the QL - 
Part 3: Squadies 


Darren Branagh 

In the first two parts of this adventures review 
series, | looked at two commercial programs, 
both by RWAP software. In this, the third 
instalment, it's time to look at a Shareware 
program - SQUADIES 


SQUADIES is a text adventure like the previous 
two, and like THE PRAWN, is a tongue in cheek 
humourous game, which is equally if not more fun 
to play. It all revolves around a military boot camp 
in the Falklands war, where you are a lowly private 
just trying to get through the daily, sometimes not 
too pleasant (including the sheep dip}, tasks of 
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the army life, at least until the flight ticket you've 
requested arrives from the movements clerk. So, 
you visit the clerk on a daily basis, hoping each 
time it will be your last. Of course, around the 
island there are various items and characters to 
help you in your task. You got sent there in the 
first place for get- 
ting caught by your 
former RSM (Regi- 
mental Sergeant 
Major) sleeping with 
his daughter which 
shows the mood 
and setting of this 
game. 


STARTING UP 


The game starts 
with a screen dis- 
playing the version 
number (the version 
| played was 1.63) and the author R.J. Weeks, one 
time QL Trader - Pointer Products. Quickly a 
scene setting paragraph is displayed outlining the 
task ahead, in which a useful clue is displayed - 
the movements clerk is rumoured to be a player 
of the pink oboe. The software company respon- 
sible is displayed on top of the screen - Flatulent 
Software. Told you it was funny. 

The instructions consist of one page of text ina 
file called Text_TXT although it is enough to get 
you Started, and gives details of how to register 
the software (since it's 
Shareware). The game is 
playable without regis- 
tering, but you won't get 
any help from the author |} 
It only costs 5 pounds to 
register. 

The BOOT program in- 
Stalls a basic extension 
to allow the program to 
set a new font for its 
display output. 

| should mention here 
that this game is 
STRICTLY for over 18's - 
it does contain lots of 
bad language, sexual jokes etc, which would be 
unsuitable for children, so it’s just for adults who 
arent easily offended - be warned! 

Pressing any key then begins the game, and the 
first description is displayed. Sadly, it doesn't have 
a cursor at this point, so if you have EXEC’ed it, 
and are not using pointer environment, tough luck, 
you're locked out of the game. 


PLATULENT SOFTUARE 


PRESS ANY KEY TO START 


South 
QHAT NOW BIG BOY ? 


You're in the Cookhouse. 


UGHAT HOW BIG BOY ? 
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Gelcome to the Falklands. The evil Commanding 
Officer has banished you to a life of shit. 
Day after dey you go to the movements clerk 
to sea if your flight ticket out has arrived, 
Rround the island, there are various items 


to halp you. [t is said, that the movements 
glerk is a bit of a player of the pink oboe. 


GOOD LUCK and don't get too drunk. 


All men look sick. # large Cockroach has 
just crapled out of a meat pie. 
The food on the hot plate has been standing 


there for over 2 hrs and is now suimming 
in fat. 

Well done Egon roney. 
EXIT E AND SE. 

There is a A COCRROACH here. 


GAMEPLAY & LAYOUT 

The gameplay is sharp and responsive and the 
new scenes are generated very fast indeed, so 
no problems there. The game layout is good, with 
a nice original font being used for the lettering, 
although all the text through- 
out the game is solely in 
green which can be dull to 
look at after a while. 

The commands parser is a 
simple verb-noun type en- 
try - you can only enter 
simple commands _ like 
TAKE SHOVEL or KILL 
BEAST, or GO NORTH. 
This is not an uncommon 
restriction in many text ad- 
venture games, especially 
public domain or freeware 
ones. Although it is in fact 
possible to chain com- 
mands together by using And and Then, e.g. the 
example in the instructions is: GET BRUSH AND 
GO NORTH THEN DROP TROUSERS 

Many of the commands can be shortened, e.g. 
LOOK can be entered as just L, NORTH can be N 
and so on. This is useful to save typing repetitive 
commands such as movement commands. 

The descriptions are not that detailed but are 
enough to provoke some thought and get you 
involved, which is the whole idea of adventure 
gaming - if they told you everything that was 
going on there wouldn't 
be any point in playing, 
would there? 

The adult humour is the 
best part of this game - 
THE PRAWN was fun- 
ny but this takes it all 
one step further When 
you stumble into the 
gents shower (drunk) 
during one part of the 
game, you hear a voice 
saying “Oh, I've drop- 
ped my soap - is there 
anyone around to pick 
it up for me?’ | wont 
Spoil it for you by saying what happens next, but 
'm sure you can guess!! 

The game also responds to you by asking things 
like “What now Big Boy?’ as a command prompt, 
which is a bit better than "| await your instructions’ 
if you know what | mean. Playing SQUADIES 
reminded me of THE PRAWN a lot and | felt very 
relaxed playing it and found time flew by - it’s 
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very easy to get engrossed in an adventure 
game and this one is no exception. 

However, | did manage to find one annoying bug. 
On loading the game | had Quill running in the 
background on my laptop so | could type this 
review and CTRL 
and C to the 
game to check 
things as | nee} = 
ded to on the fly. 
However, in 
doing this | found 
that on. starting 


QHAT NOQ BIG BOY ? 


You're now in the living accomadation 


SQUADIES, the oe tee heen sick and the cockroaches are 
machine Swit: Banh, , HET here. 

ches CAPS : , 

LOCK on and if QHAT NOW BIG BOY ? 

you try to TARE ENIFEQ 


switch it off, it 
won't work. The 
machine jams in 
CAPS LOCK mode - only a reset will cure it. | have 
checked this on a Minerva QL, Aurora, a Toshiba 
486 laptop and my own Acer Pentium laptop 
under QPC - all with the same results. Actually, as 
soon as the game is EXEC’d, the capsiock light of 
machines with caps lock lights comes on and will 
not go out, no matter how many times you press 
it - even going back to basic will not cure it. 

| found this annoying, although | doubt I'd had 
found it apart from the fact | wanted to do the 
review at the same time as the game. For most 
people this won't be a problem, as they'll be doing 
one or the other I've played SQUADIES loads of 
times before in the past few years with no pro- 
blems. 

| think this will be the same 
on all QL systems, even na- 
tive hardware, as well as 
emulators as | believe it to 
be a deliberate programming 
function by the author to 
force people to enter their 
commands in all caps mode, 
as this must be the only me- 
thod the interpreter under- 
stands. The system variable 
at 163976 normally contains 
the values Q (for CAPS 
LOCK off) or -256 for CAPS 
LOCK on. Squadies seems 
to change this to +256 which appears to confuse 
a QL. After leaving Squadies, | found | had to 
POKE_W 1639760 to restore normal CAPS 
LOCK operation. Obviously, only if the system 
variables are at the original QL location! 


A Pub 


QHAT GU BIG BOY ? 


TARE TEETH 


ORAY 
UHAT HOU BIG BoY ? 
E 
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The Army colour scheme of Puke Green se 
Qalnut Orange really sets the mood. Fro 
one room snoring can be heard. On iavestigating 
you find a very drunk Soldier lying on 4 


bed with a empty hottle of beer in his hand. 


In this one there are old men sitting around 
the bar talking of Sheep. One sees you and 
starts to become angry as your not aloud 

in here. This is the Benys oun pub if I aas 
7 I would exit quickly. 

EX 


There is ah SET OF FALSE TEETH here. 


Another annoying feature is that the boot pro- 
gram pokes the device name from which the 
game is to run into address hex 280AB (decimal 
164012). While the QL Technical manual says this 
is not used, it is in fact a pair of long word pointers 
to the Toolkit 2 PROG_USE 
and DATA_USE defaults and 
nobbles these system varia- 
bles, try PRINT PROGD$§ after- 
wards to see what | mean 
(save any work first!), Always 
assuming the system variables 
are at that location of course, 
which they probably won't be 
on a modern emulator or any- 
thing with a larger than usual 
screen. So you have to make 
sure your system is in QL 
compatible mode first and even 
then, be prepared to reset the 
machine afterwards because 
of the CAPS LOCK problem. 

Still, not to worry. SQUADIES is great fun, even if 
the humour is a little over the top at times. | 
enjoyed it a lot, from the grumpy pay officer 
complaining of his piles, to the drunken officer in 
the mess tent being sick - should bring the 
memories flooding back to any of you that have 
ever been in the army! 

When grabbing items or whatever, be careful of 
the spelling - at one stage the phrase ‘A PAKET 
OF CHIPS’ crops up for example. 

It's not that difficult to get to see a lot of the game 
too without getting killed or something equally 
awful happening to you. When you do get caught, 
yOu can usually 
see it coming but 
just can't prevent 
the inevitable hap- 
pening, which is a 
little different. 

So, there you have 
it Probably the 
best bit about 
SQUADIES is that 
it's almost free! 
There is a 5 
pounds shareware 
registration if you 
want any help. 
Other than that, it 
won't cost you penny, apart from a small copying 
charge for the disk and/or media. It is available 
from Ron Dunnett of Qubbesoft P/D on his disk 
PD8, along with several other programs on the 
same disk and will probably soon be available 
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from Phil Jordan's new library service too. 

If you've been lukewarm about the idea of buying 
and trying an adventure game up to now, maybe 
because of the cost involved {although most are 
quite cheap), then why not cut your teeth on this, 
it will cost you close to nothing and is well worth 


it - have fun! 


Little hint, if you can't suss out the vocabulary it 
uses, or want to cheat to get some extra clues, 


view the ADV_EXE file itself on he screen (eg. 
load it into an editor). The text is not encoded in 
any way - you Can see the words it understands 
embedded somewhere in the file! One word it 
understands is BONK, which gives you another 
clue as to the flavour of this game! 


Next issue we'll look at another new area - our 
first graphical adventure review. 


You and Your Programs - just 


good Friends? 


Part 3 - System Compatibilities 


Geoff Wicks 


At the 1997 Byfleet Workshop 
my worst nightmare became a 
reality. | went to the show with 
a new version of one of my 
programs. On arrival | thrust the 
review copy into the hands of 
the QL Today editor With an 
equal display of efficiency he 
immediately appointed a re- 
viewer Ten minutes later the 
reviewer announced, “It doesn't 
work on my machine" 

| had fallen foul of a compa- 
tibility problem between SMSQ 
and SMSQ/E. 

QL users are alert to incompa- 
tibilities between the numerous 
QL ROMS and operating sys- 
tems, but perhaps not to a 
more subtle form of system 
incompatibility. 

Take monitors for example. In 
use within the QL community 
are a wide range of monitors 
from the CGA green screens 
to the latest SVGA. It would not 
surprise me to discover some 
people still using a TV set. 

lf you are writing software for 
other users, do not assume 
that their monitor works like 
yours. My first monitor which 
gave many years of faithful 
service, gave a sharp contrast 
that made it unpleasant to 
work with white letters on a 
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black screen. Where possible | 
used green letters on a black 
background, a practice | had to 
unlearn when | started to write 
commercial software. On many 
monitors green letters are too 
faint to read easily, making 
white letters on a black back- 
ground essential. Now many 
QL users have higher quality 
PC monitors, and want black 
letters on a white background, 
which is recommended from a 
health and safety viewpoint. 


FRIENDLY SOFTWARE RULE: 
Where possible, allow users to 
configure their own screen 
colours. 

lf you allow users to configure 
screen colours or other pro- 
gram items, try to do this in a 
user friendly way. | prefer not to 
put screen colours into a confi- 
guration block, as the user has 
to remember the colours and 
cannot see the effect of any 
colour change immediately. It is 
much better to do this in the 
program itself 

Mice are another hardware 
complication. They are not yet 
an essential QL peripheral, but 
they are for PCs. QL users tend 
to be either lovers or haters of 
mice. 


You should write programs that 
are easy for both users and 
non-users of mice. In practice 
most pointer QL programs do 
this adequately. Indeed PC soft- 
ware authors could learn much 
from the pointer implemen- 
tation on the QL. 

What are the essentials? Firstly 
make sure your pointer is visi- 
ble whenever it is needed, and 
cannot be confused with the 
program's cursor On most PC 
programs the input windows 
are small. The pointer is thin 
and |-shaped and the cursor a 
thicker vertical line. | find it easy 
to confuse the two, particularly 
when | am tired. 

A pointer is what it says, a 
“pointer”. The tip is a point, and 
only the tip has to be within the 
input window. On a PC the en- 
tire pointer has to be in the 
input window and this can ob- 
scure the text that is being 
inputted. Make your pointer a 
true “pointer’ and make it large 
enough to be seen. 

It is easy to lose pointers, even 
if you possess a couple of 
Jonathan Hudson's eyes, parti 
cularly now high resolution 
screens are common. Make 
Sure your pointer is visible on 
all points of the screen. In 
practice this means a pointer 
Should always have at least 
two colours. Think about your 
program's colours when de- 
signing your pointer If you use 
the Easyptr suite, Easysprite 
contains a useful facility to exa- 
mine your pointer on different 
coloured backgrounds. 
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FRIENDLY SOFTWARE RULE: 
Make sure your pointer is 
readily visible on all parts of the 
screen. 

Now think about your own 
mouse use, particularly in one 
of the more complica- =. 
ted PC programs. Do Rha 
you use the mouse all . 
the time? Do you use | 
key presses all the 24 
time? Or do you use a #3) 
mixture? | suspect [Aj 
most of us do the last iy 
of these. Make sure | 
your programs allow a 
mixture of both mouse 
and key press use. 
Let's now take a look 
at one QL program, 
LineDesign. | have cho- 
sen this because it illustrates 
both good and bad points in 
mouse and pointer program- 
ming. Think about when you 
use a mouse and when key 
presses when you use this 
program. 

LineDesign has a well de- 
signed screen layout. There is 
a large working area for the 
page, and the menus do not 
get in the way of this working 
area. At the top left hand side 
of the screen are the main 
commands. You can access 
these by either the mouse or a 
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key press. The key press is 
highlighted in red. Press one of 
these keys and a submenu 
appears. Again this can be ac- 
cessed by either the mouse or 
a key press, and the key press 


is denoted by underlining. Avai- 
lable menu items are in black 
ink, unavailable ones in green. 
Full marks to PROGS so far 

On the left hand side of the 
screen there are 10 icons. 
These are compact and well 
designed. Even if you have only 
a simple knowledge of the 
program, it is clear what they 
do. Again full marks to PROGS. 
What is less clear is that all 
these icon commands can be 
accessed by a single key 
press. How many LineDesign 
users know these key pres- 


Fe Attributes FS Display Undo Agsin Keep 
Node: 


ses? They are in the manual 
but not on the screen. The first 
minus point for PROGS. 
FRIENDLY SOFTWARE RULE: 
lf you use icons in your pro- 
gram, make sure the purpose 
of the icon is clear 

On the top right hand 
1 side of the screen are 
| three more commands, 
| Undo, Again and Keep. 
| These can be accessed 
| by either the mouse or a 
| key press, but which 
_ key? You would not 
/ guess they were ESC, 
_ FQ and + respectively. 

_ ln practice when | am 
Fusing LineDesign | do 


“ not worry about using a 
mouse to access the 


icons, as the distances 
between the page and the icon 
are not great. | do, however, get 
irritated when using these 
three commands, because | 
cannot remember the key 
press, and have to move the 
pointer over a long distance to 
access them. 

FRIENDLY SOFTWARE RULE: 
Always allow the user a dis- 
played key press to avoid un- 
necessary long pointer move- 
ments. 

Next time: Problems, not solu- 
tions! 


QL Internetting 


Dilwyn Jones 


Using the various Search En- 
gines available to Internet 
users, | have compiled a list of 
Internet/World Wide Web sites 
which contain Sinclair QL rela- 
ted material. | was pleasantly 
surprised by the amount of 
QL-related material available. 

| confess | had to use a PC to 
get hold of this material, but we 
can all dream of the day when 
we can surf from QDOS or 
SMSQ - happy surfing! 
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To get on the Internet using a 
PC youll need to get the 
services of an ISP (internet 
Service Provider). In general, 
youll need a dial-up account to 


access the internet via a mo- 
dem from home. These ISP 
companies will often give you 
free software or an automated 
program to set up your PC 

ready to surf the Net - 
1 this is useful if like me 
you know little ornothing 


~ about PCs and wish to 


make the process as 
painless as possible. 
Examples of some free 
British ISPs are listed be- 
low, you can generally 
find their contact ad- 
~ dresses or telephone 
, numbers from their ad- 
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verts in the computer Sa 
press. When | say ‘free’ 
ISPs, | mean you don't 
generally have to pay a 
monthly subscription for 
normal usage, just the 
cost of telephone calls 
(usually at local call rates) 
on their internet access 
numbers. When choos- 
ing an ISP check if they 
have a telephone sup- 


port line, how much that costs 
(typically about 50p per minute 


TescoNet, 
VirginNet, 
X-Stream 
Some companies 
such as SoftNet 
provide either a 
‘free’ service or a 
subscription 
based service. 
While you may 
pay around 5 or 
10 pounds a 
month for this 
subscription ser- § 
vice, you may get bene- 


in Britain with the free ISPs), are 
you likely to receive a lot of 
advertising in return for ‘free’ 
access, and in general, take the 
advice of friends already on the 
Net - a personal recommenda- 
tion is as good as any other 
guide! 

Free’ ISPs examples: 

British Telecom ClickFree, 
Freeserve (Dixons), 

Cable & Wirele ss Lite, 
FreeDotNet, 

Gateway.net free, 


http: //www.adski.demon.co.uk/computer. htm 

http: //utopia. knoware.nl/stuurmn/sql.htm 
http://www. devili.iki.fi/pub/emulators/Sinclair/QL/ 
http://www. arrgh.demon.co.uk/hardware/ql/index. html 
http: //www.arrgh.co.uk/hardware/qi/index. html 
http: //home.sol.no/ borretze/arvid.htm 
http://www. geocities.com/SiliconValley/Lab/5011/ 
http: //www.info-point.co.uk/wnr/ 

http: //www.q-v-d.demon.co.uk/smsge.html 
http://www. telcom.es/camelot/sql.htm 

http: //members.aol.com/clubbbs/catug/ 

http 


http: //www.q40.de 
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SoftNet Free (Software Warehouse), 


fits such as less advertising, 
free or lower cost telephone 


Jonathan Hudson's Dead Letter Drop site 


support when things go wrong 
and so on. 

Most ISPs will Jet you have your 
own email address (some will 
let you have more than one, up 
to 5 addresses (one for each of 
your family?) seems quite com- 
mon, but you may have to 
change address if you switch 
to a different ISP This leaves 
you with the problem of letting 
your friends and colleagues 
know your new email address, 
but that’s probably no more of 
a problem than notifying them 


Planet Sinclair site in Norway 


all of a change of telephone 
number! 

After that introduction, 
s here's the list of URLs or 
addresses of sites for 
you to visit. If anyone 
knows of any more 
QL-related Web sites, 
please let us have the 
Web address and we'll 
publish them for the 
benefit of all QLers. 


(Adders Lair} 
(Albert's Virtual Computer Museum) 
(Ancient File library) 


(Arrgh’s Old Computers sites) 

(Arvid Borretzen’'s site in Norway) 
(Beginners Club, Italy) 

(Bill Richardson) 

(Bruce Nicholls, of Quo Vadis Design) 


(Camelot old computers web site, Spanish} 
(Chicago area Timex/Sinclair User Group) 
://dialspace.dial.pipex.com/town/square/chriss/machines/intros/ql.htm 


(Chris Stratford) 
(Claus Graf Q40 site, Germany) 
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http: 


http: 


//members.aol.com/KuElWien/index.htm 

(Club KuEL, Austria - German/French, includes details of QL-PD-CDR from Gerhard Plavec) 
//www.geocities.com/SiliconValley/Vista/4807/ 
(Club QL International's Web site, includes some downloadable back issues of their newsletters) 


http: //www.geocities.com/SiliconValley /heights/1296 (Daniele Terdina, Italy) 
http: //www.itimpi.freeserve.co.uk 
(Dave Walker's home page, support for C68 and some of George Gwilt's software) 
http: //www.sectorsoftware.demon.co.uk 
(David Batty, Sector Software, a former QL software supplier site still contains details of his QL 
software, some of which is still available) 
http: //www. geocities.com/SiliconValley/Park/6533/davideeng. htm 
(Davide Santachiara's English Web site) 
http: //www.herrnsdorf.com/europro/linksmsq. html (E.C-Herrnsdorf) 
http: //www.ndirect.co.uk/~e. tedeschi/index.htm (Enrico Tedeschi's Sinclair site, including QL) 
http: //users.cybercity.dk/ “dko3588/index. html 
(Erling Jacobsen, Denmark, web site for Xchange etc} 
http: //www. examina.net/eforenzi/personal.htm (Eros Forenzi, ttaly) 
http: //www.novanet.it/qitaly/ (Eros Forenzi, Q-ltaly site) 
http: //romblon. dbs. informatik.uni-muenchen.de/ *krojer/ql/ (Franz Krojer, Germany) 
http: //perso.club-internet. fr/ggenty/qlfr.htm (French QL page) 
http: //members. tripod. com/ “FWDComputing/ (FWD Computing site, USA) 
http: //garbo.uwasa.fi/ql/pas. html (Garbo archive in Finland) 
http: //www.hophop.com/ql (Giorgio Garabello’s Italian QL page) 
http: //www.geocities.com/SiliconValley/Park/4410/ (Hans Peter Recktenwald) 
http: //www. home9999. demon. co.uk/ql.htm (Jack Mitchell's QL site) 
http: //people.a2000.n1/jbredenb/index. html (Jan Bredenbeek’s homepage) 
http: //www. geocities.com/SiliconValley/Vista/9483/ 

(Jeremy Davis, describes himself as ‘The Man From Microdrive’} 
http://www. j-m-s.com/smsq.htm (Jochen Merz Software) 
http: //rand. thn. htu.se/ (Johan Klockars pages, Sweden) 
http: //members. tripod. com/hes_computing/hesi.html 

{John Rish, Home Electronics Service, USA) 
http://www. komkon.org/EMUL8/Macintosh/ql/index.htm1 (John Stiles, QL emulators on Macs) 
http: //www. jrhudson.demon.co.uk 

(Jonathan Hudson's Dead Letter Drop site, packed full of useful information and a lot of free 

downloadable software) 

http: //www.ellis-online.co.uk/sinclair/ql.html (Kev Ellis QL page} 
http: //www.heydon.org/kevan/collection/manufacturer-sinclair/ 

(Kevan Heydon collectors site) 
http: //www.dces.port.ac.uk/ “lesterc/ (Kit Lester's home page) 
http: //pages. vossnet.de/manpet/ql.htm (Manuel Petridis, Germany) 
http: //www.compulink.co.uk/ “digby/Mapej .htm1 (Mapej disk copying service, incl. QL) 
http: //www.deuschle.de/qpe/index. html (Marcel Kilgus, Germany. QPC support site 
http: //www.xs4all.nl/ wij2/ql.htm (Marco Vacquier’s page) 
http: //pages.unisonfree.net/mswift/files/QZ/index.html 

(Mark Swift pages - QDOS Classic and Q40) 
http: //wuarchive.wustl.edu/pub/aminet/info/www/dirs/aminet/misc/ 
emu/QDO0S4amigal. readme (Mark Swift/Rainer Kowllik Amiga emulator) 
http: //hem1.passagen.se/baslista/ql.html 
http://www. jamt.net/speccy .html 


http: 


http: 
http: 
http: 
http: 
http: 


//www.cronsten.pp.se/ql.htm 
(Michael Cronsten’s QL Web sites in Sweden, includes loads of pictures of QLs) 


//wow.atari_computer.de/mjaap/computer/sinclair_QL. htm (M Jaap site} 
//www.sinclair-research.co.uk (Need | say who?) 
//www.airnet.net/boehm/ (NESQLUG site, USA} 
//wwu.betechdata.no/thomas/ql/index. html (Norwegian Sinclair QL homepage) 


//directory.mozilla.org/Computers /Operating Systems/Sinclair/QL/ 
(Open Directory - Computer Operating Systems) 
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http: //www.anit.es/pedro/ 
(Pedro Reina, Spain - some English and Spanish content, some software} 
http: //www.pborman.freeserve.co.uk/ 

(Phil Borman’s page. NB his previous Web site on wwwpborman.demon.co.uk is no longer available) 
http://www. nvg.ntnu.no/sinclair/index2.htm (Planet Sinclair Norway} 
http: //www. triathlon98.com/PROGS/ (PROGS Web site, Belgium) 
http: //www. dur.ac.uk/ ~“dedlbrh/Q-Route/index. html (Q-Route software web site} 
http: //www.qbranch.demon.co.uk/ (QBranch site} 
http: //www.emulation.net/ql/ (QemuLator etc} 
http: //www.mwn.net/infomac/app/q_emulator_lite_096.html (QemuLator site) 
http: //web. inter.nl.net/hec/A.Jaw. Venema (QLay site, Jan Venema) 
http: //www.home.swipnet.se/w-14406/emu/sinclair.html (QL, emulators, tools, etc) 
http: //forums.bruin.net/egi-bin/fbn/fbn.cgi/bruin.comp.sinclair.gl (QL Forum on Bruin 
http: //www.hernsdorf.com/texts/qlintnet. txt (QL on the internet article 
http: //www.geocities.com/SiliconValley/Bay/2602 (Richard Zidlicky, uUQLx emulator etc 
http: //www.uni-maing.de/“roklein/ql/ (Robert Klein, Germany - QL FAQ etc 
http://www. di-ren.demon.co.uk/ (Robin Barker's Di-Ren Web site 
http: //rwap.webjump.com/ (RWAP Software 
http: //www.xs4all.nl/1jb/singlair. html (SinQLair site, Netherlands 
http: //www.gm. fh-koeln. de/ ~it048/ (Stephan's Retrocomputing Site 
http: //www. em. fh-koeln. de/ ~it048/emulator/ql/ 

(Stephan Suberkrub QL emulator site, Germany} 
http://www. firshman.demon.co.uk (TF Services site, includes information about the new Q40)} 
http: //www.angelfire.com/il/dbaum ("The Strange World Of Daniel Baum’, Israel - in English} 
http: //wwwusers. imaginet.fr/godefroy/english/frames. html 

(Thierry Godefroy - this site is widely regarded as one of the best QL internet sites) 
http: //www.uni-karlsruhe.de/ “Thomas .Much/QL/ (Thomas Much web site, Germany) 
http: //users.aol.com/clubbbs/tsnug/ (Timex/Sinclair North American User Groups} 
http: //www.geocities.com/SiliconValley/Pines/5865/ (Timothy Swenson - site includes 

copies of previously printed articles, QL Hackers Journal and some software) 


http: //members.aol.com/clubbbs/akahale. html 


Some FTP And News Sites 


ftp: //garbo.uwasa.fi/ql 
ftp: //wuarchive.wustl.edu/systems/sinclair 
ftp: //ftp.nvg.ntnu.no/pub/sinclair 

ftp: //ftp.gui.uva.es/sinclair/ql 

ftp: //ftp.demon.co.uk/pub/qdos/ 


news: //news.ext. Jussieu. fr/comp.sys.sinclair 

news: //news .uni-stuttgart.de/maus.computer.ql.intl 
news: //news.uni-stuttgart.de/maus.computer.qli.c 
news: //news.uni-stuttgart.de/maus.computer.ql.de 


(FidoNet/MausNet mirror of IntlLQL 
(FidoNet/MausNet mirror of Sinclair 
(MausNet mirror of computerql.de 


(ZXir QLive Alive! pages) 


(Garbo archives at University of Vaasa, Finland - Timo Salmi 


) 
(Maya and Garbo mirror site) 
(All sinclair computers) 

(Luna site) 

(Demon's FTP site} 


(Sinclair computers newsgroup 
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SOFTWARE 
Min MILLENIUM BUG? 

eg Cl- OX We have received a 

help request concerning the 

use of the Payroll and Cash 

Trader softwares which appear 

not to be year-2000 compliant, 

in the sense that they appear 

to reject attempts to specify 
post-1999 dates. 

Does anyone know how to get 

around these problems, or 


have a patch that can be 
applied to the programs - e.g. if 
the tests are of a form “if year > 
1999 OR year « 1985 then 
reject’ it may be possible to 
patch the test limits to work 
around these limitations. 

lf anyone can help Mr Smith 
with these problems, please 
contact him on 

(+44) 0181-534 4916 
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rane ney wher QL Users Group 


Worldwide Membership is by subscription 
only, and offers the following benefits: 
Monthly Newsletter - up to 40 pages 
Massive Software Library - All Free ! 
Free Helpline and Workshops 
Regional Sub-Groups. One near you? 
Advice on Software and Hardware problems 
Subscription just £14 for UK members 
Overseas subscription £17 


Barclaycard: Visa: Access: Mastercard 
* Now in our SIXTEENTH successful year * 


Further details from the Membership Secretary 
Bill Newell 


213 Manor Road ior 
Benfleet a 
Essex 


SS7 4JD 
Tel. (01268) 754407 
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. 7 Don H. Smith 

AA | writes: The flashing 

~ cursor on my JS QL 

+ Trump Card is so faint | can 
scarcely see It. Is it possible in 
a short line or two to adjust 
the cursor brightness? 
Reply: We asked for helo on 
this via the QL Users Email 
Mailing List and got several 
replies. 
The cursor brightness is set in 
hardware and cannot be 
changed on your system. The 
cursor colour on your machine 
is derived from EORing the 
background PAPER colour with 
binary O11 and ‘set in stone’ 
unless, as Dave Westbury advi- 
ses, you have a Minerva ROM, 
where the following command 
sets a white flashing cursor. 
POKE !124151,71 
The value 71 is a_ binary 
number represented by 
rrrrsccc where the four high 
bits rrr represent Rate, s 
represents Size and the lower 
3 bits cce represents the co- 
lour. 
John R. Rish of Home Elec- 
tronics Service in Texas USA 
advised checking the moni- 
tor's brightness and contrast 
settings - if set too dark, red 
against black would be hard to 
read. 
Tony Firshman also suggested 
that users experiencing this 
problem who have an RGB 
colour monitor and some elec- 
tronic knowledge could try ad- 
ding series resistance in the 
DIN plug on the GB (Green- 
Blue) lines, say 40 to 80 ohms. 
There should be some balance 
adjusters in the monitor, but this 
is not for the uninitiated. 
For Gold Card users, back in 
Volume 2 Issue 9 of QL World, 
Bruno Coativy gave a function 
which found the cursor colour 
mask in the ROM area, which is 
in RAM in fact on a Gold Card, 
and poked in new values to 
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change the colour of the 
cursor In mode 4 or mode 8. 
Sadly, this only worked on 
early Gold Cards. Later ones 


Something missing? 
lf you read so far through QL Today, then you know that 
issues usually end with Byts of Wood. Mark Knight's 
article has not reached us yet. Which reminds me - if you 
found the layout of Mark's article in the last issue 
confusing, apologies - the next part will be differently 
formatted. The other missing bit is Jochen’s Things 
article part 2 ... which has to wait for the next issue as 
well - it will be in there, promised. 


write protected this area to 
prevent the content being acci- 
dentally or deliberately over- 
written. 


First a big thank you to the or- 
ganisers of the two US shows 
at the end of May. The East 
coast show was hastily taken 
over after the sad death of Bob 
Gilder who originally doing the 
organizational honours. During 
that show Tony Firshman and | 
encountered one problem 
which may be set people who 
want to build new Aurora or 
Q 40 systems into tower ca- 
ses. Many of the cases aval 
lable at the moment use the 
ATX configuration and, whilst 
the board fits into the case 
there are several problems you 
will come up against if you 
decide to use one of these. 
The first is the position of the 
keyboard outlet. The Q 40 was 
designed to fit into an AT case 
and in one of these cases the 
keyboard socket lines up nicely 
with the hole in the case. On an 
ATX board the position of the 
outlet is different and the hole 
is designed for PS/2 plug (mini- 
DIN) so this makes things har- 
der. 


An even more serious problem 
is the power supply itself The 
concept behind the ATX mo- 
therboard is that the PC can be 
activated by a software event 
such as an incoming fax signal. 
The sockets for the power are 
different to the usual P8, P9 
sockets found in AT cases and 
have extra connections for a 
switch on the motherboard 
which !Is used to activate the 
power supply from a standby 
mode. Needless to say this 
does not work very well on 
either the Q 40 or the Aurora. 
The QPlane is also set up for 
the standard AT plugs so that 
won't accept the ATX plug and, 
although the Q 40 and Mplane 
both use the standard hard 
drive plug the power supply 
cannot be turned on unless 
the relay Is tripped. 

lf anyone has the relevant infor- 
mation about the wiring of the 
ATX switch could they please 
let us know so we Can publish 
it. AT Cases are becoming rarer 
SO we need to know how to 
use an ATX power supply. 
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DIY MIDI 

Simon Goodwin put in a wel- 
come appearance at the two 
shows demonstrating a natty 
piece of software that he wrote 
for the East Coast Group. This 
uses the QL network as a MIDI 
interface and allows you to play 
mult-voiced tunes on a synthe- 
siser connected to your QL. 
The package includes a text 
file which explains how to wire 
the cable and bears all the 
usual hallmarks of the Simon's 
innovative software. The soft- 
ware is available via NESQLUG 
at the moment because they 
sponsored Simon's work and 
his air fares. 

it is always good to see people 
like Simon re-appear after a 
long absence from the QL 
scene. At one point he was one 
of the most active members of 
this community and certainly 
provided many people with 
their first introduction to pro- 
gramming with his DIY Toolkit 
series in the, now defunct, QL 
World magazine. Maybe, with a 
little support and encourage- 
ment from the rest of us, we 
can tempt him back into doing 
a lot more QL programming. 


All This and QPC II 
Marcel Kilgus made his first US 
trio with us this time and 
seemed overjoyed to find out 
that my laptop behaved exactly 
the same way that Jochen’s 
Desktop PC did when QPC II 
tried to read its floppy disk 
drive. Marcel’s eyes lit up at this 
and he spent a good part of 
the first show monopolising my 
machine while he tried to find 
out what was actually happen- 
ing. 

| am pleased to say that he 
solved the problem (clever little 
sod!) and | can now copy to 
and from the floppy drive with 
no problem. The version that 
was sold at the US Is still not 
fully operational. The printer 
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port and the serial ports are 
not working 100% but it is now 
very close and maybe this 
issue of the magazine will he- 
rald the final release version. 


It’s Not All Roses 

On the whole the US. trip was 
pretty enjoyable although there 
were one or two things which 
were not quite as good as they 
might have been. | put a mes- 
sage up on the Newsgroup on 
the Internet asking people to 
place specific orders so | could 
be sure to bring the things they 
wanted. What do you_ think 
they asked for the most? Rich 
Mellors SBASIC/SuperBasic 
Reference Manual - the hea- 
viest thing they could order! 

Of course this was not the 
biggest problem that we faced. 
We were trying to be very cost 
conscious on this trio but we 
wound up spending our first 
few nights in the ‘Motel from 
Hell’. This was the kind of place 
where even the cockroaches 
wore gas masks and the other 
‘human’ occupants were even 
less savoury. | leave this to 
your imagination but | was cer- 
tainly glad to be heading off to 
California. Glad, that is, until we 
attempted to get on the flight. 
Although we confirmed the 
flight by telephone Tower Air 
failed to mention that it was 
running 6 hours late. The plane 
was old, dirty and the toilet 
failed to function - not bad for a 
six hour flight. On the way over 
we flew above the thunder- 
storm which downed the flight 
in Little Rock. This was very 
exciting and pretty from above 
but disastrous from below. 


QL 2000 

At the end of the East Coast 
show the organisers held a dis- 
cussion about all things QL. 
One of the items on the board 
was about where to hold a 
show next year and many of 


the people opted for a visit to 
the UK. While | am not willing 
to give up my annual trip to the 
US | am very keen on the idea 
of having a big international 
show next year Pushing all the 
arguments about whether the 
millennium starts next year or 
the year after | really do think it 
is time that we had a big 
weekend get together and 
invited QL users world wide to 
attend. 

| have already discussed this 
with QUANTA since _ they 
should be the ultimate hosts 
and they are generally in favour 
of the idea so now we need to 
get it off the ground. it would 
need to be in the spring, | think, 
because the overseas visitors 
would also like to get a bit of 
sightseeing in and | think it 
Should be just before the air 
fares go up for the summer 
Now all we need is the place... 


It’s not Cricket 

Just when you think that you 
have something sewn up life 
throws you a googly. 

| recently acquired a new moni- 
tor for my original QL. For a 
while it had been running on a 
Microvitec Cub which was OK 
but had an occasional fit pro- 
ducing some very odd buzzing 
and popping noises together 
with a flashing screen. This is 
not only annoying but can be 
lethal to the 8301 chip so | was 
very pleased to be offered a 
new RGB monitor This QL sits 
on a desk in my office and has 
a Standard Gold Card and a 
couple of Miracle DD drives 
plugged into it. It spends most 
of its time formatting DD disks 
but | do also use it to test pro- 
grams and Super Gold/Gold 
Cards that get returned as faul- 
ly. 

Since this was a monitor type 
which | had never seen before ! 
had no idea of the pin-outs at 
the rear so | turned to Keith 
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Mitchell who is a repository of 
knowledge on these things and 
he made a new cable for me to 
use. The new monitor was 
Crisp and very good to use so! 
was quite happy with it. Then... 


| got a Super Gold Card re- 
turned to me which was only 
getting part of the way through 
its startup screen. This fault is 
usually due to faulty ram chips 
but | thought that | would plug it 
in and test it out. It didn't work 
at all. | stil have a few new 
boards which are minus the 
1810 chip so | took out the 1810 
from the faulty board and 
plugged it into the new one - 
Nothing. | tried a SGC which | 
knew was working - Nothing. 
At this point | suspected the 
cables. Maybe | had pulled a 
wire loose from one of the 
connecting cables. | plugged 
the Gold Card back in - that 
worked. 

OK maybe it is the QL. | tried 
another one. Same results. 
This was all getting to be very 
frustrating and | began to 
suspect that | had seriously 
trashed some part of the 
system so | plugged the Gold 
Card back in. Now it worked 
again. | sat down with a cup of 
tea and pondered the problem. 
The only difference between 
this system and the one that | 
had used to test Super Gold 
Cards before was the monitor 
but it can't be that - can it? 

A quick phone call to Keith re- 
vealed the answer and here it 
is. 

The Super Gold Card uses the 
QL Composite Sync signal at 
B13 on the expansion connec- 
tor to help generate its memo- 
ry refresh signal. There is no 
buffering on the QL between 
the monitor output and the ex- 
pansion connector and_ this 
means that some monitors 
which have a low impedance 
Sync input will pull the signal 
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low enough to stop the Super 
Gold Card from working. 

This is not a problem with the 
Aurora because the expansion 
connector signal is not related 
to the video monitor outputs. 
The standard Gold Card gene- 
rates its memory refresh in a 
different way to the Super Gold 
Card so that works Ok too. 

All in all an interesting, if frustra- 
ting, problem. 


I’m Not Scart 
Another __ little 
teaser that re- 
cently crossed 
our — threshold 
was how to 
connect a scart 
plug to a QL 
monitor lead. My 
first real QL mo- 


nitor was a 
Phillips CM 
8533. (I did have 
a few awful 
ones before oe 
that including an 
IBM CGA moni- GREEN 
tor which was 
OK if a bit hazy) RED 
This was a very 
good monitor 
with a clean 
crisp display 


and | still have it 
in the shop to 
run up a stan- 
dard system if | 
need it It also 
have a Scart 
Connector on 
the back and | used a cable 
supplied by Ron Dunnett of 
Qubbesoft. 

Scart, for those of you who do 
not know about it, was an 
attempt at a standard TV and 
video connector which could 
carry sound and actually be 
used to switch on the TV if the 
Video is switch on. It also has a 
signal line which can be used 
to select RGB on the display 
device if it is wired to detect it. 


| 100R | 


Earth Return, 
Connect to 5, 9, , 13 and 14 also 


Keith Mitchell has looked into 
this and produced the diagram 
here to allow you to wire a 
cable for yourself if you want. 
We don't guarantee that it will 
work with all devices with a 
Scart input but recent years 
have seen the standard settle 
down. Most modern TVs with a 
scart input plug can be 
triggered into RGB mode but 
we do not have details on all of 
them. 


QL PLUG 
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RGB mode is selected if pin 16 is at +1V 
to +3V irrespective of the level on pin 8. 
Rectified Csync acheives this. 


Its Not Just Words 

Geoff Wicks is very active at 
the moment and | have just 
received a very interesting Beta 
test program from him. It takes a 
piece of text from either Quill 
Perfection or Text 87 and con- 
verts it into Rich Text Format for 
use with a PC word processor | 
have been looking at this piece 
of software with great interest 
because | recently met some- 
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one who had written several 
short books using Quill and 
needed to send them to the 
publisher in a PC format. | sus- 
pect there are others of you out 
there with similar needs so this 
new product will be eagerly 
awaited. There is no release 
date for this so dont pester 
Geoff for a copy just yet though 
the version | have been looking 
at is already very far advanced. 


Bye Bye BBS 
Just as | write a bit in this co- 
lumn praising the BBS system 
and exhorting you all to use it | 
learn that Phil Borman has 
closed his Nene Valley BBS 
down. Phil is devoting more of 
his time to his family now and 
is, aS such, not going to be as 
active in the QL scene as he 
once was. This is a shame be- 
cause he was one of the guid- 
ing lights behind the software 
side of the Qubide and certain- 
ly wrote some very interesting 
and useful utilities for users. 
Apart from this he provided 
PBox, the software that runs 
the QL BBS system. His web 
site is still up and running (see 
Dilwyn’s list in this issue) and 
there are still four other func- 
tioning QL BBS's to access: 
QBBS run by Tony Firshman 
+44 (0)1442 828255 
QBOX run by Jochen Merz 
+49 (0}203 502013 or 502014 
QLCF run by Thierry Godefroy 
+33 (0)498 430320 
QBOX-USA 
+1 810 254 9878 


Don't forget these can be ac- 
cessed via QTPI and a modem 
on a standard QL (with super- 
Hermes IS best to get the high 
speed serial and discrete 
mouse channels). They can 
also be accessed equally 
easily on a PC running a 
terminal program. 

| think I'll write an article about 
how good Windows is now - 


maybe | can get them to close 
down too. 


A Colourful Paris in the 
Autumn (perhaps) 


A couple of people have repor- 
ted problems with the Q 40 to 
me and while | visited Jochen 
recently | found out the reason. 
One of the problems concerned 
the size of the screen with the 
Q 40. In the SMSQ/E version 
this is limited to 512 x 256 even 
though there is a configuration 
item in the program which sug- 
gests that higher resolutions are 
available. The other problem is 
odder and relates to the 
SBASIC. George Gwilt found 
that, although you can start a 
new SBASIC job off in the 
normal way you Cannot use 'C- 
TRL C’ to jump from that pro- 
gram to another He later dis- 
covered, when issuing an 
‘OUTLINE’ command in one of 
these BASICs to enable the 
pointer environment, that the 
‘CTRL C’ function was restored. 
These are puzzling circumstan- 
ces and strangely enough both 
this problem and the lack of 
higher screen resolutions have 
the same root. The colour dri- 
vers for the Q 40 already exist 
in skeletal alpha test format and 
when Tony released the Q 40 
O/S he removed them and in- 
serted a modified standard QL 
display as a standby until they 
are finished. The version that he 
used for this will only allow you 
to use the ‘CTRL C’ switch if the 
SBASIC window you create is at 
least one row or one column of 
pixels short of full sized (ie. 511 x 
256 or 512 x 255). This, says 
Jochen, ‘Is just the theory’ and, 
since | am here in Duisburg with 
my laptop and not my Q 40 | will 
test it when | get back. Any 
changes to this report may or 
may not make it onto the page. 
Thierry Godefroy {it's that man 
again!) announced recently that 
Tony Tebby will attend the Paris 


show with high colour driver for 
the Q 40! 1 love Paris in ithe 
Autumn when it’s colourful... 
While | am mentioning the Q 40 
and, since | got the chance to 
read through the proto-QL To- 
day in Jochen's office | noticed 
a couple of things in Bill Waugh's 
article on the machine which 
need mentioning. The two serial 
ports are not fixed as SERI and 
SER2. The plate which holds the 
sockets for the ports is con- 
nected to the main I/O card with 
two seperate ripbon cables - 
one for each port. These both 
terminate in exactly the same 10 
pin IDC plug so you can choose 
which port goes with which 
socket. The reason Tony sug- 
gests that you choose the high- 
est port number for the mouse 
is that it searches from SER4 
back to SER1 for a mouse. It 
makes the startup faster if it 
finds the mouse right at the 
start and then carries on with 
the rest of its work. 


Endspeace 

Also being able to read through 
this very issue enables a quick 
reply to two of David Denham’s 
comments in his piece on his 
boot file and use of Qascade. 

lf you want to get Filelnfo Il to 
act from a Qascade menu use 
this line: 

FI2;Maillist; Wini_ maillist_ddf 
modified for your own filenames 
of course. 

Also you will find a little program 
called Mclock in the Qascade 
archive. lf you execute this you 
will get a neat little button with a 
clock and the free memory dis- 
played. You can assign two pro- 
grams to this button by using 
the environment variables (one 
for each mouse Click, left or 
right) so | have chosen to 
assign the left click to the 
calendar thus: 

740 SETENV "MCLICK_1=wini_ calendar" 
Very useful this. 

a 


) The QL Show Agenda: 


International OL Meeting - (NL) Eindhoven 
Saturday, 4th of September 1999! 
Held at its usual Venue: St. Joris College. 
The meeting starts at 10am and ends at 4pm. 
All major QL dealers will be there! 


OL Show - (F) Paris 
Saturday, 18th of September 


The QLCF international meeting will take place in Paris on 18th September 1999. 
| The venue: Ecole Supérieure d’Informatique, 23 rue du Chateau Landon (near Gare 


du Nord - North Station), Paris Xéme. Tel. 01 53 35 97 00. 
| The meeting will start at 10:00 and will end at 18:00. Tony Tebby will be there with the | 
| new Q40 colour driver (so he told us)... 


All major QL dealers will be there! 


\. Other software authors are expected as well, Wolfgang Lenerz, Albin Hessler etc. 


Quanta workshop - (GB) Byfleet 
Sun., 3rd of October 1999 


Same venue as every year: The Byfleet Village Hall. The meeting will start at 
10am and will end at Spm. Pick up the next issue of OL Today there!!! 


OL Meeting - (A) Heidenreichstein 
Sat./Sun., 9./10.th of October 1999! 


Same venue as last time: Gasthof Nobauer. 
Definitely a very nice, social event too! 


_ Austrian meetings are always more than "just" a QL meeting. This time, a Visit to a narrow gaug 
railway and a model train exhibition is planned. Please contact us for more details! 


